1 /* GObject - GLib Type, Object, Parameter and Signal Library
2 * Copyright (C) 1997, 1998, 1999, 2000 Tim Janik and Red Hat, Inc.
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Lesser General Public
6 * License as published by the Free Software Foundation; either
7 * version 2 of the License, or (at your option) any later version.
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Lesser General Public License for more details.
14 * You should have received a copy of the GNU Lesser General
15 * Public License along with this library; if not, write to the
16 * Free Software Foundation, Inc., 59 Temple Place, Suite 330,
17 * Boston, MA 02111-1307, USA.
25 /* --- typedefs & structures --- */
35 /* --- variables --- */
36 static GHashTable *param_exchange_ht = NULL;
39 /* --- functions --- */
41 g_value_init (GValue *value,
44 GTypeValueTable *value_table = g_type_value_table_peek (g_type);
46 g_return_if_fail (value != NULL);
47 g_return_if_fail (G_VALUE_TYPE (value) == 0);
51 memset (value, 0, sizeof (*value));
52 value->g_type = g_type;
53 value_table->value_init (value);
56 g_warning (G_STRLOC ": cannot initialize value of type `%s' which has no GTypeValueTable",
57 g_type_name (g_type));
61 g_value_copy (const GValue *src_value,
64 GTypeValueTable *value_table;
66 g_return_if_fail (G_IS_VALUE (src_value));
67 g_return_if_fail (G_IS_VALUE (dest_value));
68 g_return_if_fail (g_type_is_a (G_VALUE_TYPE (src_value), G_VALUE_TYPE (dest_value)));
70 value_table = g_type_value_table_peek (G_VALUE_TYPE (dest_value));
72 g_return_if_fail (g_type_value_table_peek (G_VALUE_TYPE (dest_value)) != NULL);
74 if (src_value != dest_value)
76 /* make sure dest_value's value is free()d and zero initialized */
77 g_value_reset (dest_value);
79 value_table->value_copy (src_value, dest_value);
84 g_value_fits_pointer (const GValue *value)
86 GTypeValueTable *value_table;
88 g_return_val_if_fail (G_IS_VALUE (value), FALSE);
90 value_table = g_type_value_table_peek (G_VALUE_TYPE (value));
92 g_return_val_if_fail (g_type_value_table_peek (G_VALUE_TYPE (value)) != NULL, FALSE);
94 return value_table->value_peek_pointer != NULL;
98 g_value_get_as_pointer (const GValue *value)
100 GTypeValueTable *value_table;
102 g_return_val_if_fail (G_IS_VALUE (value), NULL);
104 value_table = g_type_value_table_peek (G_VALUE_TYPE (value));
106 g_return_val_if_fail (g_type_value_table_peek (G_VALUE_TYPE (value)) != NULL, NULL);
107 if (!value_table->value_peek_pointer)
108 g_return_val_if_fail (g_value_fits_pointer (value) == TRUE, NULL);
110 return value_table->value_peek_pointer (value);
114 g_value_unset (GValue *value)
116 GTypeValueTable *value_table = g_type_value_table_peek (G_VALUE_TYPE (value));
118 g_return_if_fail (G_IS_VALUE (value));
120 g_return_if_fail (g_type_value_table_peek (G_VALUE_TYPE (value)) != NULL);
122 if (value_table->value_free)
123 value_table->value_free (value);
124 memset (value, 0, sizeof (*value));
128 g_value_reset (GValue *value)
130 GTypeValueTable *value_table = g_type_value_table_peek (G_VALUE_TYPE (value));
133 g_return_if_fail (G_IS_VALUE (value));
135 g_type = G_VALUE_TYPE (value);
137 if (value_table->value_free)
138 value_table->value_free (value);
139 memset (value, 0, sizeof (*value));
141 value->g_type = g_type;
142 value_table->value_init (value);
146 exchange_entries_equal (gconstpointer v1,
149 const ExchangeEntry *entry1 = v1;
150 const ExchangeEntry *entry2 = v2;
152 return (entry1->value_type1 == entry2->value_type1 &&
153 entry1->value_type2 == entry2->value_type2);
157 exchange_entry_hash (gconstpointer key)
159 const ExchangeEntry *entry = key;
161 return entry->value_type1 ^ entry->value_type2;
165 value_exchange_memcpy (GValue *value1,
170 memcpy (&tmp_value.data, &value1->data, sizeof (value1->data));
171 memcpy (&value1->data, &value2->data, sizeof (value1->data));
172 memcpy (&value2->data, &tmp_value.data, sizeof (value2->data));
175 static inline GValueExchange
176 exchange_func_lookup (GType value_type1,
180 if (value_type1 == value_type2)
181 return value_exchange_memcpy;
184 GType type1 = value_type1;
188 GType type2 = value_type2;
192 ExchangeEntry entry, *ret;
194 entry.value_type1 = MIN (type1, type2);
195 entry.value_type2 = MAX (type1, type2);
196 ret = g_hash_table_lookup (param_exchange_ht, &entry);
200 *need_swap = ret->first_type == type2;
205 type2 = g_type_parent (type2);
209 type1 = g_type_parent (type1);
218 g_value_register_exchange_func (GType value_type1,
224 g_return_if_fail (g_type_name (value_type1) != NULL);
225 g_return_if_fail (g_type_name (value_type2) != NULL);
226 g_return_if_fail (func != NULL);
228 entry.value_type1 = MIN (value_type1, value_type2);
229 entry.value_type2 = MAX (value_type1, value_type2);
230 if (param_exchange_ht && g_hash_table_lookup (param_exchange_ht, &entry))
231 g_warning (G_STRLOC ": cannot re-register param value exchange function "
233 g_type_name (value_type1),
234 g_type_name (value_type2));
237 ExchangeEntry *entry = g_new (ExchangeEntry, 1);
239 if (!param_exchange_ht)
240 param_exchange_ht = g_hash_table_new (exchange_entry_hash, exchange_entries_equal);
241 entry->value_type1 = MIN (value_type1, value_type2);
242 entry->value_type2 = MAX (value_type1, value_type2);
244 entry->first_type = value_type1;
245 g_hash_table_insert (param_exchange_ht, entry, entry);
250 g_value_types_exchangable (GType value_type1,
253 g_return_val_if_fail (G_TYPE_IS_VALUE (value_type1), FALSE); /* these might bite us, think G_TYPE_ENUM */
254 g_return_val_if_fail (G_TYPE_IS_VALUE (value_type2), FALSE);
256 return exchange_func_lookup (value_type1, value_type2, NULL) != NULL;
260 g_values_exchange (GValue *value1,
263 g_return_val_if_fail (G_IS_VALUE (value1), FALSE);
264 g_return_val_if_fail (G_IS_VALUE (value2), FALSE);
266 if (value1 != value2)
269 GValueExchange value_exchange = exchange_func_lookup (G_VALUE_TYPE (value1),
270 G_VALUE_TYPE (value2),
275 value_exchange (value2, value1);
277 value_exchange (value1, value2);
280 return value_exchange != NULL;
287 g_value_convert (const GValue *src_value,
290 gboolean success = TRUE;
292 g_return_val_if_fail (G_IS_VALUE (src_value), FALSE);
293 g_return_val_if_fail (G_IS_VALUE (dest_value), FALSE);
295 if (src_value != dest_value)
297 GValue tmp_value = { 0, };
299 g_value_init (&tmp_value, G_VALUE_TYPE (src_value));
300 g_value_copy (src_value, &tmp_value);
302 success = g_values_exchange (&tmp_value, dest_value);
303 g_value_unset (&tmp_value);