DataList

Members

Static functions

clear

void clear(GData** datalist)

Frees all the data elements of the datalist. The data elements' destroy functions are called if they have been set.

foreac

void foreac(GData** datalist, GDataForeachFunc func, void* userData)

Calls the given function for each data element of the datalist. The function is called with each data element's #GQuark id and data, together with the given @user_data parameter. Note that this function is NOT thread-safe. So unless @datalist can be protected from any modifications during invocation of this function, it should not be called.

getData

void* getData(GData** datalist, string key)

Gets a data element, using its string identifier. This is slower than g_datalist_id_get_data() because it compares strings.

getFlags

uint getFlags(GData** datalist)

Gets flags values packed in together with the datalist. See g_datalist_set_flags().

idDupData

void* idDupData(GData** datalist, GQuark keyId, GDuplicateFunc dupFunc, void* userData)

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.

idGetData

void* idGetData(GData** datalist, GQuark keyId)

Retrieves the data element corresponding to @key_id.

idRemoveNoNotify

void* idRemoveNoNotify(GData** datalist, GQuark keyId)

Removes an element, without calling its destroy notification function.

idReplaceData

bool idReplaceData(GData** datalist, GQuark keyId, void* oldval, void* newval, GDestroyNotify destroy, GDestroyNotify oldDestroy)

Compares the member that is associated with @key_id in @datalist to @oldval, and if they are the same, replace @oldval with @newval.

idSetDataFull

void idSetDataFull(GData** datalist, GQuark keyId, void* data, GDestroyNotify destroyFunc)

Sets the data corresponding to the given #GQuark id, and the function to be called when the element is removed from the datalist. Any previous data with the same key is removed, and its destroy function is called.

init

void init(GData** datalist)

Resets the datalist to %NULL. It does not free any memory or call any destroy functions.

setFlags

void setFlags(GData** datalist, uint flags)

Turns on flag values for a data list. This function is used to keep a small number of boolean flags in an object with a data list without using any additional space. It is not generally useful except in circumstances where space is very tight. (It is used in the base #GObject type, for example.)

unsetFlags

void unsetFlags(GData** datalist, uint flags)

Turns off flag values for a data list. See g_datalist_unset_flags()

• DataList