sl@0: /* GObject - GLib Type, Object, Parameter and Signal Library sl@0: * Copyright (C) 1998-1999, 2000-2001 Tim Janik and Red Hat, Inc. sl@0: * sl@0: * This library is free software; you can redistribute it and/or sl@0: * modify it under the terms of the GNU Lesser General Public sl@0: * License as published by the Free Software Foundation; either sl@0: * version 2 of the License, or (at your option) any later version. sl@0: * sl@0: * This library is distributed in the hope that it will be useful, sl@0: * but WITHOUT ANY WARRANTY; without even the implied warranty of sl@0: * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU sl@0: * Lesser General Public License for more details. sl@0: * sl@0: * You should have received a copy of the GNU Lesser General sl@0: * Public License along with this library; if not, write to the sl@0: * Free Software Foundation, Inc., 59 Temple Place, Suite 330, sl@0: * Boston, MA 02111-1307, USA. sl@0: * sl@0: * gvaluecollector.h: GValue varargs stubs sl@0: */ sl@0: /** sl@0: * SECTION:value_collection sl@0: * @Short_description: Converting varargs to generic values sl@0: * @See_also:#GValueTable sl@0: * @Title: Varargs Value Collection sl@0: * sl@0: * The macros in this section provide the varargs parsing support needed sl@0: * in variadic GObject functions such as g_object_new() or g_object_set(). sl@0: * They currently support the collection of integral types, floating point sl@0: * types and pointers. sl@0: */ sl@0: #ifndef __G_VALUE_COLLECTOR_H__ sl@0: #define __G_VALUE_COLLECTOR_H__ sl@0: sl@0: #include sl@0: sl@0: G_BEGIN_DECLS sl@0: sl@0: /* we may want to add aggregate types here some day, if requested sl@0: * by users. the basic C types are covered already, everything sl@0: * smaller than an int is promoted to an integer and floats are sl@0: * always promoted to doubles for varargs call constructions. sl@0: */ sl@0: enum /*< skip >*/ sl@0: { sl@0: G_VALUE_COLLECT_INT = 'i', sl@0: G_VALUE_COLLECT_LONG = 'l', sl@0: G_VALUE_COLLECT_INT64 = 'q', sl@0: G_VALUE_COLLECT_DOUBLE = 'd', sl@0: G_VALUE_COLLECT_POINTER = 'p' sl@0: }; sl@0: sl@0: sl@0: /* vararg union holding actuall values collected sl@0: */ sl@0: /** sl@0: * GTypeCValue: sl@0: * sl@0: * A union holding one collected value. sl@0: */ sl@0: union _GTypeCValue sl@0: { sl@0: gint v_int; sl@0: glong v_long; sl@0: gint64 v_int64; sl@0: gdouble v_double; sl@0: gpointer v_pointer; sl@0: }; sl@0: sl@0: /** sl@0: * G_VALUE_COLLECT: sl@0: * @value: a #GValue return location. @value is supposed to be initialized sl@0: * according to the value type to be collected sl@0: * @var_args: the va_list variable; it may be evaluated multiple times sl@0: * @flags: flags which are passed on to the collect_value() function of sl@0: * the #GTypeValueTable of @value. sl@0: * @__error: a #gchar** variable that will be modified to hold a g_new() sl@0: * allocated error messages if something fails sl@0: * sl@0: * Collects a variable argument value from a va_list. We have to sl@0: * implement the varargs collection as a macro, because on some systems sl@0: * va_list variables cannot be passed by reference. sl@0: */ sl@0: #define G_VALUE_COLLECT(value, var_args, flags, __error) \ sl@0: G_STMT_START { \ sl@0: GValue *_value = (value); \ sl@0: guint _flags = (flags); \ sl@0: GType _value_type = G_VALUE_TYPE (_value); \ sl@0: GTypeValueTable *_vtable = g_type_value_table_peek (_value_type); \ sl@0: gchar *_collect_format = _vtable->collect_format; \ sl@0: GTypeCValue _cvalues[G_VALUE_COLLECT_FORMAT_MAX_LENGTH] = { { 0, }, }; \ sl@0: guint _n_values = 0; \ sl@0: \ sl@0: if (_vtable->value_free) \ sl@0: _vtable->value_free (_value); \ sl@0: _value->g_type = _value_type; /* value_meminit() from gvalue.c */ \ sl@0: memset (_value->data, 0, sizeof (_value->data)); \ sl@0: while (*_collect_format) \ sl@0: { \ sl@0: GTypeCValue *_cvalue = _cvalues + _n_values++; \ sl@0: \ sl@0: switch (*_collect_format++) \ sl@0: { \ sl@0: case G_VALUE_COLLECT_INT: \ sl@0: _cvalue->v_int = va_arg ((var_args), gint); \ sl@0: break; \ sl@0: case G_VALUE_COLLECT_LONG: \ sl@0: _cvalue->v_long = va_arg ((var_args), glong); \ sl@0: break; \ sl@0: case G_VALUE_COLLECT_INT64: \ sl@0: _cvalue->v_int64 = va_arg ((var_args), gint64); \ sl@0: break; \ sl@0: case G_VALUE_COLLECT_DOUBLE: \ sl@0: _cvalue->v_double = va_arg ((var_args), gdouble); \ sl@0: break; \ sl@0: case G_VALUE_COLLECT_POINTER: \ sl@0: _cvalue->v_pointer = va_arg ((var_args), gpointer); \ sl@0: break; \ sl@0: default: \ sl@0: g_assert_not_reached (); \ sl@0: } \ sl@0: } \ sl@0: *(__error) = _vtable->collect_value (_value, \ sl@0: _n_values, \ sl@0: _cvalues, \ sl@0: _flags); \ sl@0: } G_STMT_END sl@0: sl@0: sl@0: /** sl@0: * G_VALUE_LCOPY: sl@0: * @value: a #GValue return location. @value is supposed to be initialized sl@0: * according to the value type to be collected sl@0: * @var_args: the va_list variable; it may be evaluated multiple times sl@0: * @flags: flags which are passed on to the lcopy_value() function of sl@0: * the #GTypeValueTable of @value. sl@0: * @__error: a #gchar** variable that will be modified to hold a g_new() sl@0: * allocated error messages if something fails sl@0: * sl@0: * Collects a value's variable argument locations from a va_list. Usage is sl@0: * analogous to G_VALUE_COLLECT(). sl@0: */ sl@0: #define G_VALUE_LCOPY(value, var_args, flags, __error) \ sl@0: G_STMT_START { \ sl@0: const GValue *_value = (value); \ sl@0: guint _flags = (flags); \ sl@0: GType _value_type = G_VALUE_TYPE (_value); \ sl@0: GTypeValueTable *_vtable = g_type_value_table_peek (_value_type); \ sl@0: gchar *_lcopy_format = _vtable->lcopy_format; \ sl@0: GTypeCValue _cvalues[G_VALUE_COLLECT_FORMAT_MAX_LENGTH] = { { 0, }, }; \ sl@0: guint _n_values = 0; \ sl@0: \ sl@0: while (*_lcopy_format) \ sl@0: { \ sl@0: GTypeCValue *_cvalue = _cvalues + _n_values++; \ sl@0: \ sl@0: switch (*_lcopy_format++) \ sl@0: { \ sl@0: case G_VALUE_COLLECT_INT: \ sl@0: _cvalue->v_int = va_arg ((var_args), gint); \ sl@0: break; \ sl@0: case G_VALUE_COLLECT_LONG: \ sl@0: _cvalue->v_long = va_arg ((var_args), glong); \ sl@0: break; \ sl@0: case G_VALUE_COLLECT_INT64: \ sl@0: _cvalue->v_int64 = va_arg ((var_args), gint64); \ sl@0: break; \ sl@0: case G_VALUE_COLLECT_DOUBLE: \ sl@0: _cvalue->v_double = va_arg ((var_args), gdouble); \ sl@0: break; \ sl@0: case G_VALUE_COLLECT_POINTER: \ sl@0: _cvalue->v_pointer = va_arg ((var_args), gpointer); \ sl@0: break; \ sl@0: default: \ sl@0: g_assert_not_reached (); \ sl@0: } \ sl@0: } \ sl@0: *(__error) = _vtable->lcopy_value (_value, \ sl@0: _n_values, \ sl@0: _cvalues, \ sl@0: _flags); \ sl@0: } G_STMT_END sl@0: sl@0: sl@0: /** sl@0: * G_VALUE_COLLECT_FORMAT_MAX_LENGTH: sl@0: * sl@0: * The maximal number of #GTypeCValues which can be collected for a sl@0: * single #GValue. sl@0: */ sl@0: #define G_VALUE_COLLECT_FORMAT_MAX_LENGTH (8) sl@0: sl@0: G_END_DECLS sl@0: sl@0: #endif /* __G_VALUE_COLLECTOR_H__ */