mirror of
https://gitlab.gnome.org/GNOME/glib.git
synced 2024-11-10 11:26:16 +01:00
bbc5a3adac
Sat Feb 17 04:55:35 2001 Tim Janik <timj@gtk.org>
* gtype.[hc]: changed collect_format, collect_value() and lcopy_format,
lcopy_value() in the GTypeValueTable. the collect functions are now
called only once per value, collect_format/lcopy_format are strings
that enlist all necessary GTypeCValues to be varargs-collected.
* gvalue.h: ranamed STATIC_TAG to G_VALUE_NOCOPY_CONTENTS to indicate that
a value shouldn't copy its contents.
* gvaluecollector.h: changed G_VALUE_COLLECT() and G_VALUE_LCOPY()
macros to carry an additional argument (flags) that can be used
to pass G_VALUE_NOCOPY_CONTENTS along to the collection functions.
* *.c: adapted collect_value() and lcopy_value() functions to the new
prototypes, support G_VALUE_NOCOPY_CONTENTS where apropriate.
* gsignal.[hc]: introduced a G_SIGNAL_TYPE_STATIC_SCOPE flag that can
be passed along (ORed) with the parameter types, indicating that the
emission arguments are to be considered static for the scope of the
emission. should be used with care and only if the caller knows that
a parameter cannot be destroyed/freed from signal handlers connected
to an emission.
154 lines
5.2 KiB
C
154 lines
5.2 KiB
C
/* GObject - GLib Type, Object, Parameter and Signal Library
|
|
* Copyright (C) 1998, 1999, 2000 Tim Janik and Red Hat, Inc.
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2 of the License, or (at your option) any later version.
|
|
*
|
|
* This library is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General
|
|
* Public License along with this library; if not, write to the
|
|
* Free Software Foundation, Inc., 59 Temple Place, Suite 330,
|
|
* Boston, MA 02111-1307, USA.
|
|
*
|
|
* gvaluecollector.h: GValue varargs stubs
|
|
*/
|
|
#ifndef __G_VALUE_COLLECTOR_H__
|
|
#define __G_VALUE_COLLECTOR_H__
|
|
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif /* __cplusplus */
|
|
|
|
|
|
/* we may want to add aggregate types here some day, if requested
|
|
* by users. the basic C types are covered already, everything
|
|
* smaller than an int is promoted to an integer and floats are
|
|
* always promoted to doubles for varargs call constructions.
|
|
*/
|
|
enum /*< skip >*/
|
|
{
|
|
G_VALUE_COLLECT_INT = 'i',
|
|
G_VALUE_COLLECT_LONG = 'l',
|
|
G_VALUE_COLLECT_DOUBLE = 'd',
|
|
G_VALUE_COLLECT_POINTER = 'p'
|
|
};
|
|
|
|
|
|
/* vararg union holding actuall values collected
|
|
*/
|
|
union _GTypeCValue
|
|
{
|
|
gint v_int;
|
|
glong v_long;
|
|
gdouble v_double;
|
|
gpointer v_pointer;
|
|
};
|
|
|
|
|
|
/* G_VALUE_COLLECT() 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.
|
|
* value is supposed to be initialized according to the value
|
|
* type to be collected.
|
|
* var_args is the va_list variable and may be evaluated multiple times.
|
|
* __error is a gchar** variable that will be modified to hold a g_new()
|
|
* allocated error messages if something fails.
|
|
*/
|
|
#define G_VALUE_COLLECT(value, var_args, flags, __error) \
|
|
G_STMT_START { \
|
|
GValue *_value = (value); \
|
|
guint _flags = (flags); \
|
|
GTypeValueTable *_vtable = g_type_value_table_peek (G_VALUE_TYPE (_value)); \
|
|
gchar *_collect_format = _vtable->collect_format; \
|
|
GTypeCValue _cvalues[G_VALUE_COLLECT_FORMAT_MAX_LENGTH] = { { 0, }, }; \
|
|
guint _n_values = 0; \
|
|
\
|
|
g_value_reset (_value); \
|
|
while (*_collect_format) \
|
|
{ \
|
|
GTypeCValue *_cvalue = _cvalues + _n_values++; \
|
|
\
|
|
switch (*_collect_format++) \
|
|
{ \
|
|
case G_VALUE_COLLECT_INT: \
|
|
_cvalue->v_int = va_arg ((var_args), gint); \
|
|
break; \
|
|
case G_VALUE_COLLECT_LONG: \
|
|
_cvalue->v_long = va_arg ((var_args), glong); \
|
|
break; \
|
|
case G_VALUE_COLLECT_DOUBLE: \
|
|
_cvalue->v_double = va_arg ((var_args), gdouble); \
|
|
break; \
|
|
case G_VALUE_COLLECT_POINTER: \
|
|
_cvalue->v_pointer = va_arg ((var_args), gpointer); \
|
|
break; \
|
|
default: \
|
|
g_assert_not_reached (); \
|
|
} \
|
|
} \
|
|
*(__error) = _vtable->collect_value (_value, \
|
|
_n_values, \
|
|
_cvalues, \
|
|
_flags); \
|
|
} G_STMT_END
|
|
|
|
|
|
/* G_VALUE_LCOPY() collects a value's variable argument
|
|
* locations from a va_list. usage is analogous to G_VALUE_COLLECT().
|
|
*/
|
|
#define G_VALUE_LCOPY(value, var_args, flags, __error) \
|
|
G_STMT_START { \
|
|
GValue *_value = (value); \
|
|
guint _flags = (flags); \
|
|
GTypeValueTable *_vtable = g_type_value_table_peek (G_VALUE_TYPE (_value)); \
|
|
gchar *_lcopy_format = _vtable->lcopy_format; \
|
|
GTypeCValue _cvalues[G_VALUE_COLLECT_FORMAT_MAX_LENGTH] = { { 0, }, }; \
|
|
guint _n_values = 0; \
|
|
\
|
|
while (*_lcopy_format) \
|
|
{ \
|
|
GTypeCValue *_cvalue = _cvalues + _n_values++; \
|
|
\
|
|
switch (*_lcopy_format++) \
|
|
{ \
|
|
case G_VALUE_COLLECT_INT: \
|
|
_cvalue->v_int = va_arg ((var_args), gint); \
|
|
break; \
|
|
case G_VALUE_COLLECT_LONG: \
|
|
_cvalue->v_long = va_arg ((var_args), glong); \
|
|
break; \
|
|
case G_VALUE_COLLECT_DOUBLE: \
|
|
_cvalue->v_double = va_arg ((var_args), gdouble); \
|
|
break; \
|
|
case G_VALUE_COLLECT_POINTER: \
|
|
_cvalue->v_pointer = va_arg ((var_args), gpointer); \
|
|
break; \
|
|
default: \
|
|
g_assert_not_reached (); \
|
|
} \
|
|
} \
|
|
*(__error) = _vtable->lcopy_value (_value, \
|
|
_n_values, \
|
|
_cvalues, \
|
|
_flags); \
|
|
} G_STMT_END
|
|
|
|
|
|
#define G_VALUE_COLLECT_FORMAT_MAX_LENGTH (8)
|
|
|
|
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif /* __cplusplus */
|
|
|
|
#endif /* __G_VALUE_COLLECTOR_H__ */
|