Method

PurplePresenceManagerfind_with_id

unstable since: 3.0

Declaration [src] 

PurpleSavedPresence*
purple_presence_manager_find_with_id (
  PurplePresenceManager* manager,
  const char* id,
  guint* position
)

Description [src]

Looks for a saved presence in the manager.

If the saved presence is found, it will be returned and if position is not NULL it will be set to the position of the saved presence in the manager.

Available since: 3.0

Parameters

id

Type: const char*

The id to search for.

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

Type: guint*

An optional return address for the position of the presence in the manager.

The argument will be set by the function.
The argument can be set to NULL by the method.

Return value

Type: PurpleSavedPresence

The item if found, otherwise NULL.

The returned data is owned by the instance.
The return value can be NULL.