Method

PurpleProtocolContactssearch_async

unstable since: 3.0

Declaration [src] 

void
purple_protocol_contacts_search_async (
  PurpleProtocolContacts* protocol_contacts,
  PurpleAccount* account,
  const char* text,
  GCancellable* cancellable,
  GAsyncReadyCallback callback,
  gpointer data
)

Description [src]

Starts the process of searching for contacts using account that match text.

Call purple_protocol_contacts_search_finish() to get the results.

Available since: 3.0

This method completes asynchronously. Use purple_protocol_contacts_search_finish() inside the GAsyncReadyCallback to obtain the result of the operation.

Parameters

account

Type: PurpleAccount

The PurpleAccount to search under.

The data is owned by the caller of the method.
text

Type: const char*

The text to search for which must not be an empty string.

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

Type: GCancellable

Optional GCancellable object, NULL to ignore.

The argument can be NULL.
The data is owned by the caller of the method.
callback

Type: GAsyncReadyCallback

A GAsyncReadyCallback to call when the request is satisfied.

The argument can be NULL.
data

Type: gpointer

User data to pass to callback.

The argument can be NULL.
The data is owned by the caller of the method.