id_get


Description:

public bool id_get (...)

Parses the variable arguments and reads fields from this accordingly.

Variable arguments should be in the form field id quark, field type (as a GType), pointer(s) to a variable(s) to hold the return value(s). The last variable argument should be null (technically it should be a 0 quark, but we require null so compilers that support it can check for the null terminator and warn if it's not there).

This function is just like @get only that it is slightly more efficient since it saves the string-to-quark lookup in the global quark hashtable.

For refcounted (mini)objects you will receive a new reference which you must release with a suitable _unref\() when no longer needed. For strings and boxed types you will receive a copy which you will need to release with either g_free or the suitable function for the boxed type.

Parameters:

this

a Structure

...

variable arguments

first_field_id

the quark of the first field to read

Returns:

false if there was a problem reading any of the fields (e.g. because the field requested did not exist, or was of a type other than the type specified), otherwise true.