Constructor

PurpleMessagenew_incoming

since: 3.0

Declaration [src]

PurpleMessage*
purple_message_new_incoming (
  const char* who,
  const char* contents,
  PurpleMessageFlags flags,
  guint64 timestamp
)

Description [src]

Creates new incoming message (the user is the recipient).

You don’t need to set the #PURPLE_MESSAGE_RECV flag.

Available since: 3.0

Parameters

who

Type: const char*

Message’s author.

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

Type: const char*

The contents of a message.

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

Type: PurpleMessageFlags

The message flags.

timestamp

Type: guint64

The time of transmitting a message. May be 0 for a current time.

Return value

Type: PurpleMessage

The new PurpleMessage.

The caller of the function takes ownership of the data, and is responsible for freeing it.