Function

PurpleImagestore_get_from_uri

since: 3.0

Declaration [src]

PurpleImage*
purple_image_store_get_from_uri (
  const gchar* uri
)

Description [src]

Checks, if the uri is pointing to any PurpleImage by referring to #PURPLE_IMAGE_STORE_PROTOCOL and returns the image, if it’s valid.

The function doesn’t throw any warning, if the uri is for any other protocol.

Available since: 3.0

Parameters

uri

Type: const gchar*

The URI of a potential PurpleImage. Should not be NULL.

The data is owned by the caller of the function.
The value is a NUL terminated UTF-8 string.

Return value

Type: PurpleImage

The image referenced by uri, or NULL if it doesn’t point to any valid image.

The data is owned by the called function.