DataList.idDupData

This is a variant of g_datalist_id_get_data() which returns a 'duplicate' of the value. @dup_func defines the meaning of 'duplicate' in this context, it could e.g. take a reference on a ref-counted object.

If the @key_id is not set in the datalist then @dup_func will be called with a %NULL argument.

Note that @dup_func is called while the datalist is locked, so it is not allowed to read or modify the datalist.

This function can be useful to avoid races when multiple threads are using the same datalist and the same key.

struct DataList
static
void*
idDupData

Parameters

datalist GData**

location of a datalist

keyId GQuark

the #GQuark identifying a data element

dupFunc GDuplicateFunc

function to duplicate the old value

userData void*

passed as user_data to @dup_func

Return Value

Type: void*

the result of calling @dup_func on the value associated with @key_id in @datalist, or %NULL if not set. If @dup_func is %NULL, the value is returned unmodified.

Meta

Since

2.34