Function

PurpleKeyValuePairnew_full

since: 3.0

Declaration [src]

PurpleKeyValuePair*
purple_key_value_pair_new_full (
  const gchar* key,
  gpointer value,
  GDestroyNotify value_destroy_func
)

Description [src]

Creates a new PurpleKeyValuePair allocating memory for key, set free value function to value_destroy_func.

Available since: 3.0

Parameters

key

Type: const gchar*

The key part of PurpleKeyValuePair.

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

Type: gpointer

The value part of PurpleKeyValuePair.

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

Type: GDestroyNotify

A function to free the memory for the value.

Return value

Type: PurpleKeyValuePair

The created PurpleKeyValuePair.

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