gvaluecollector.h File Reference

Enum anonymous

SECTION:value_collection : Converting varargs to generic values :#GValueTable : Varargs Value Collection

The macros in this section provide the varargs parsing support needed in variadic GObject functions such as g_object_new() or g_object_set(). They currently support the collection of integral types, floating point types and pointers.

G_VALUE_COLLECT

G_VALUE_COLLECT: : a GValue return location. is supposed to be initialized according to the value type to be collected : the va_list variable; it may be evaluated multiple times : flags which are passed on to the collect_value() function of the GTypeValueTable of . : a gchar** variable that will be modified to hold a g_new() allocated error messages if something fails

Collects a variable argument value from a va_list. We have to implement the varargs collection as a macro, because on some systems va_list variables cannot be passed by reference.

G_VALUE_LCOPY

G_VALUE_LCOPY: : a GValue return location. is supposed to be initialized according to the value type to be collected : the va_list variable; it may be evaluated multiple times : flags which are passed on to the lcopy_value() function of the GTypeValueTable of . : a gchar** variable that will be modified to hold a g_new() allocated error messages if something fails

Collects a value's variable argument locations from a va_list. Usage is analogous to G_VALUE_COLLECT().

G_VALUE_COLLECT_FORMAT_MAX_LENGTH

G_VALUE_COLLECT_FORMAT_MAX_LENGTH:

The maximal number of #GTypeCValues which can be collected for a single GValue.