Method

PurpleHistoryadd_message_async

unstable since: 3.0

Declaration [src]

void
purple_history_add_message_async (
  PurpleHistory* history,
  PurpleMessage* message,
  GCancellable* cancellable,
  GAsyncReadyCallback callback,
  gpointer data
)

Description [src]

Adds a message.

If the message does not yet have an id, it will be given a randomly generated UUID.

If the message does not have a timestamp, it will be set to the current time.

message will be sorted inserted according to messages created timestamp and no duplication checking is performed.

Available since: 3.0

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

Parameters

message

Type: PurpleMessage

The message.

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

Type: GCancellable

An optional cancellable.

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

Type: GAsyncReadyCallback

An optional callback.

The argument can be NULL.
data

Type: gpointer

The user data to pass to the callback.

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