1 /* GTK - The GIMP Toolkit
2 * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Library 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 * Library General Public License for more details.
14 * You should have received a copy of the GNU Library General Public
15 * 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.
22 #include "gtkobject.h"
23 #include "gtksignal.h"
26 #define GTK_OBJECT_DATA_ID_BLOCK_SIZE (1024)
27 #define GTK_OBJECT_DATA_BLOCK_SIZE (1024)
39 ARG_OBJECT_SIGNAL_AFTER
43 typedef struct _GtkObjectData GtkObjectData;
49 GtkDestroyNotify destroy;
54 void gtk_object_init_type (void);
55 static void gtk_object_base_class_init (GtkObjectClass *klass);
56 static void gtk_object_class_init (GtkObjectClass *klass);
57 static void gtk_object_init (GtkObject *object);
58 static void gtk_object_set_arg (GtkObject *object,
61 static void gtk_object_get_arg (GtkObject *object,
64 static void gtk_object_shutdown (GtkObject *object);
65 static void gtk_object_real_destroy (GtkObject *object);
66 static void gtk_object_finalize (GtkObject *object);
67 static void gtk_object_notify_weaks (GtkObject *object);
69 static guint object_signals[LAST_SIGNAL] = { 0 };
71 static GHashTable *object_arg_info_ht = NULL;
73 static const gchar *user_data_key = "user_data";
74 static guint user_data_key_id = 0;
75 static const gchar *weakrefs_key = "gtk-weakrefs";
76 static guint weakrefs_key_id = 0;
78 static GtkObjectData *gtk_object_data_free_list = NULL;
80 #define GTK_OBJECT_DATA_DESTROY( odata ) { \
82 odata->destroy (odata->data); \
83 odata->next = gtk_object_data_free_list; \
84 gtk_object_data_free_list = odata; \
89 static guint obj_count = 0;
90 static GHashTable *living_objs_ht = NULL;
92 gtk_object_debug_foreach (gpointer key, gpointer value, gpointer user_data)
96 object = (GtkObject*) value;
97 g_message ("[%p] %s\tref_count=%d%s%s",
99 gtk_type_name (GTK_OBJECT_TYPE (object)),
101 GTK_OBJECT_FLOATING (object) ? " (floating)" : "",
102 GTK_OBJECT_DESTROYED (object) ? " (destroyed)" : "");
105 gtk_object_debug (void)
108 g_hash_table_foreach (living_objs_ht, gtk_object_debug_foreach, NULL);
110 g_message ("living objects count = %d", obj_count);
112 #endif /* G_ENABLE_DEBUG */
114 /****************************************************
115 * GtkObject type, class and instance initialization
117 ****************************************************/
120 gtk_object_init_type (void)
122 GtkType object_type = 0;
123 GtkTypeInfo object_info =
127 sizeof (GtkObjectClass),
128 (GtkClassInitFunc) gtk_object_class_init,
129 (GtkObjectInitFunc) gtk_object_init,
130 /* reserved_1 */ NULL,
131 /* reserved_2 */ NULL,
132 (GtkClassInitFunc) gtk_object_base_class_init,
135 object_type = gtk_type_unique (0, &object_info);
136 g_assert (object_type == GTK_TYPE_OBJECT);
138 #ifdef G_ENABLE_DEBUG
139 if (gtk_debug_flags & GTK_DEBUG_OBJECTS)
140 g_atexit (gtk_object_debug);
141 #endif /* G_ENABLE_DEBUG */
145 gtk_object_get_type (void)
147 return GTK_TYPE_OBJECT;
151 gtk_object_base_class_init (GtkObjectClass *class)
153 /* reset instance specific fields that don't get inhrited */
154 class->signals = NULL;
158 /* reset instance specifc methods that don't get inherited */
159 class->get_arg = NULL;
160 class->set_arg = NULL;
164 gtk_object_class_init (GtkObjectClass *class)
166 gtk_object_add_arg_type ("GtkObject::user_data",
170 gtk_object_add_arg_type ("GtkObject::signal",
174 gtk_object_add_arg_type ("GtkObject::signal_after",
178 gtk_object_add_arg_type ("GtkObject::object_signal",
182 gtk_object_add_arg_type ("GtkObject::object_signal_after",
185 ARG_OBJECT_SIGNAL_AFTER);
187 object_signals[DESTROY] =
188 gtk_signal_new ("destroy",
191 GTK_SIGNAL_OFFSET (GtkObjectClass, destroy),
192 gtk_marshal_NONE__NONE,
195 gtk_object_class_add_signals (class, object_signals, LAST_SIGNAL);
197 class->get_arg = gtk_object_get_arg;
198 class->set_arg = gtk_object_set_arg;
199 class->shutdown = gtk_object_shutdown;
200 class->destroy = gtk_object_real_destroy;
201 class->finalize = gtk_object_finalize;
205 gtk_object_init (GtkObject *object)
207 GTK_OBJECT_FLAGS (object) = GTK_FLOATING;
209 object->ref_count = 1;
210 object->object_data = NULL;
212 #ifdef G_ENABLE_DEBUG
213 if (gtk_debug_flags & GTK_DEBUG_OBJECTS)
218 living_objs_ht = g_hash_table_new (g_direct_hash, NULL);
220 g_hash_table_insert (living_objs_ht, object, object);
222 #endif /* G_ENABLE_DEBUG */
225 /********************************************
226 * Functions to end a GtkObject's life time
228 ********************************************/
230 gtk_object_destroy (GtkObject *object)
232 g_return_if_fail (object != NULL);
233 g_return_if_fail (GTK_IS_OBJECT (object));
235 if (!GTK_OBJECT_DESTROYED (object))
237 /* we will hold a reference on the object in this place, so
238 * to ease all classes shutdown and destroy implementations.
239 * i.e. they don't have to bother about referencing at all.
241 gtk_object_ref (object);
242 object->klass->shutdown (object);
243 gtk_object_unref (object);
248 gtk_object_shutdown (GtkObject *object)
250 GTK_OBJECT_SET_FLAGS (object, GTK_DESTROYED);
251 gtk_signal_emit (object, object_signals[DESTROY]);
255 gtk_object_real_destroy (GtkObject *object)
257 if (GTK_OBJECT_CONNECTED (object))
258 gtk_signal_handlers_destroy (object);
262 gtk_object_finalize (GtkObject *object)
264 gtk_object_notify_weaks (object);
266 while (object->object_data)
268 GtkObjectData *odata;
270 odata = object->object_data;
271 object->object_data = odata->next;
272 GTK_OBJECT_DATA_DESTROY (odata);
275 gtk_type_free (GTK_OBJECT_TYPE (object), object);
278 /*****************************************
279 * GtkObject argument handlers
281 *****************************************/
284 gtk_object_set_arg (GtkObject *object,
295 gtk_object_set_user_data (object, GTK_VALUE_POINTER (*arg));
297 case ARG_OBJECT_SIGNAL_AFTER:
299 case ARG_OBJECT_SIGNAL:
301 case ARG_SIGNAL_AFTER:
305 arg_name = gtk_arg_name_strip_type (arg->name);
307 arg_name[n] == ':' &&
308 arg_name[n + 1] == ':' &&
309 arg_name[n + 2] != 0)
311 gtk_signal_connect_full (object,
313 GTK_VALUE_SIGNAL (*arg).f, NULL,
314 GTK_VALUE_SIGNAL (*arg).d,
316 (arg_id == ARG_OBJECT_SIGNAL ||
317 arg_id == ARG_OBJECT_SIGNAL_AFTER),
318 (arg_id == ARG_OBJECT_SIGNAL_AFTER ||
319 arg_id == ARG_SIGNAL_AFTER));
322 g_warning ("gtk_object_set_arg(): invalid signal argument: \"%s\"\n", arg->name);
330 gtk_object_get_arg (GtkObject *object,
337 GTK_VALUE_POINTER (*arg) = gtk_object_get_user_data (object);
340 case ARG_OBJECT_SIGNAL:
342 arg->type = GTK_TYPE_INVALID;
347 /*****************************************
348 * gtk_object_class_add_signals:
353 *****************************************/
356 gtk_object_class_add_signals (GtkObjectClass *class,
363 g_return_if_fail (class != NULL);
365 new_signals = g_new (guint, class->nsignals + nsignals);
366 for (i = 0; i < class->nsignals; i++)
367 new_signals[i] = class->signals[i];
368 for (i = 0; i < nsignals; i++)
369 new_signals[class->nsignals + i] = signals[i];
371 g_free (class->signals);
372 class->signals = new_signals;
373 class->nsignals += nsignals;
377 gtk_object_class_add_user_signal (GtkObjectClass *class,
379 GtkSignalMarshaller marshaller,
389 g_return_val_if_fail (class != NULL, 0);
393 params = g_new (GtkType, nparams);
395 va_start (args, nparams);
397 for (i = 0; i < nparams; i++)
398 params[i] = va_arg (args, GtkType);
405 signal_id = gtk_signal_newv (name,
417 gtk_object_class_add_signals (class, &signal_id, 1);
423 gtk_object_class_user_signal_new (GtkObjectClass *class,
425 GtkSignalRunType signal_flags,
426 GtkSignalMarshaller marshaller,
436 g_return_val_if_fail (class != NULL, 0);
440 params = g_new (GtkType, nparams);
442 va_start (args, nparams);
444 for (i = 0; i < nparams; i++)
445 params[i] = va_arg (args, GtkType);
452 signal_id = gtk_signal_newv (name,
464 gtk_object_class_add_signals (class, &signal_id, 1);
470 gtk_object_class_user_signal_newv (GtkObjectClass *class,
472 GtkSignalRunType signal_flags,
473 GtkSignalMarshaller marshaller,
480 g_return_val_if_fail (class != NULL, 0);
483 g_return_val_if_fail (params != NULL, 0);
485 signal_id = gtk_signal_newv (name,
495 gtk_object_class_add_signals (class, &signal_id, 1);
500 /*****************************************
506 *****************************************/
509 gtk_object_sink (GtkObject *object)
511 g_return_if_fail (object != NULL);
512 g_return_if_fail (GTK_IS_OBJECT (object));
514 if (GTK_OBJECT_FLOATING (object))
516 GTK_OBJECT_UNSET_FLAGS (object, GTK_FLOATING);
517 gtk_object_unref (object);
521 /*****************************************
524 * Weak refs are very similar to the old "destroy" signal. They allow
525 * one to register a callback that is called when the weakly
526 * referenced object is finalized.
528 * They are not implemented as a signal because they really are
529 * special and need to be used with great care. Unlike signals, which
530 * should be able to execute any code whatsoever.
532 * A weakref callback is not allowed to retain a reference to the
533 * object. Object data keys may be retrieved in a weak reference
536 * A weakref callback is called at most once.
538 *****************************************/
540 typedef struct _GtkWeakRef GtkWeakRef;
545 GtkDestroyNotify notify;
550 gtk_object_weakref (GtkObject *object,
551 GtkDestroyNotify notify,
556 g_return_if_fail (object != NULL);
557 g_return_if_fail (notify != NULL);
558 g_return_if_fail (GTK_IS_OBJECT (object));
560 if (!weakrefs_key_id)
561 weakrefs_key_id = g_quark_from_static_string (weakrefs_key);
563 weak = g_new (GtkWeakRef, 1);
564 weak->next = gtk_object_get_data_by_id (object, weakrefs_key_id);
565 weak->notify = notify;
567 gtk_object_set_data_by_id (object, weakrefs_key_id, weak);
571 gtk_object_weakunref (GtkObject *object,
572 GtkDestroyNotify notify,
575 GtkWeakRef *weaks, *w, **wp;
577 g_return_if_fail (object != NULL);
578 g_return_if_fail (GTK_IS_OBJECT (object));
580 if (!weakrefs_key_id)
583 weaks = gtk_object_get_data_by_id (object, weakrefs_key_id);
584 for (wp = &weaks; *wp; wp = &(*wp)->next)
587 if (w->notify == notify && w->data == data)
590 gtk_object_set_data_by_id (object, weakrefs_key_id, w->next);
600 gtk_object_notify_weaks (GtkObject *object)
606 w1 = gtk_object_get_data_by_id (object, weakrefs_key_id);
610 w1->notify (w1->data);
618 /****************************************************
619 * GtkObject argument mechanism and object creation
621 ****************************************************/
624 gtk_object_new (GtkType object_type,
625 const gchar *first_arg_name,
630 GSList *arg_list = NULL;
631 GSList *info_list = NULL;
634 g_return_val_if_fail (GTK_FUNDAMENTAL_TYPE (object_type) == GTK_TYPE_OBJECT, NULL);
636 object = gtk_type_new (object_type);
638 va_start (var_args, first_arg_name);
639 error = gtk_object_args_collect (GTK_OBJECT_TYPE (object),
648 g_warning ("gtk_object_new(): %s", error);
656 slist_arg = arg_list;
657 slist_info = info_list;
660 gtk_object_arg_set (object, slist_arg->data, slist_info->data);
661 slist_arg = slist_arg->next;
662 slist_info = slist_info->next;
664 gtk_args_collect_cleanup (arg_list, info_list);
671 gtk_object_newv (GtkType object_type,
678 g_return_val_if_fail (GTK_FUNDAMENTAL_TYPE (object_type) == GTK_TYPE_OBJECT, NULL);
680 g_return_val_if_fail (args != NULL, NULL);
682 object = gtk_type_new (object_type);
684 for (max_args = args + n_args; args < max_args; args++)
685 gtk_object_arg_set (object, args, NULL);
691 gtk_object_setv (GtkObject *object,
697 g_return_if_fail (object != NULL);
698 g_return_if_fail (GTK_IS_OBJECT (object));
700 g_return_if_fail (args != NULL);
702 for (max_args = args + n_args; args < max_args; args++)
703 gtk_object_arg_set (object, args, NULL);
707 gtk_object_getv (GtkObject *object,
713 g_return_if_fail (object != NULL);
714 g_return_if_fail (GTK_IS_OBJECT (object));
716 g_return_if_fail (args != NULL);
718 for (max_args = args + n_args; args < max_args; args++)
719 gtk_object_arg_get (object, args, NULL);
723 gtk_object_set (GtkObject *object,
724 const gchar *first_arg_name,
728 GSList *arg_list = NULL;
729 GSList *info_list = NULL;
732 g_return_if_fail (object != NULL);
733 g_return_if_fail (GTK_IS_OBJECT (object));
735 va_start (var_args, first_arg_name);
736 error = gtk_object_args_collect (GTK_OBJECT_TYPE (object),
745 g_warning ("gtk_object_set(): %s", error);
753 slist_arg = arg_list;
754 slist_info = info_list;
757 gtk_object_arg_set (object, slist_arg->data, slist_info->data);
758 slist_arg = slist_arg->next;
759 slist_info = slist_info->next;
761 gtk_args_collect_cleanup (arg_list, info_list);
766 gtk_object_arg_set (GtkObject *object,
770 GtkObjectClass *oclass;
772 g_return_if_fail (object != NULL);
773 g_return_if_fail (GTK_IS_OBJECT (object));
774 g_return_if_fail (arg != NULL);
780 error = gtk_arg_get_info (GTK_OBJECT_TYPE (object),
786 g_warning ("gtk_object_arg_set(): %s", error);
792 if (! (info->arg_flags & GTK_ARG_WRITABLE))
794 g_warning ("gtk_object_arg_set(): argument \"%s\" is not writable",
798 if (info->type != arg->type)
800 g_warning ("gtk_object_arg_set(): argument \"%s\" has invalid type `%s'",
802 gtk_type_name (arg->type));
806 oclass = gtk_type_class (info->class_type);
807 g_assert (oclass->set_arg != NULL);
808 oclass->set_arg (object, arg, info->arg_id);
812 gtk_object_arg_get (GtkObject *object,
816 GtkObjectClass *oclass;
818 g_return_if_fail (object != NULL);
819 g_return_if_fail (GTK_IS_OBJECT (object));
820 g_return_if_fail (arg != NULL);
826 error = gtk_arg_get_info (GTK_OBJECT_TYPE (object),
832 g_warning ("gtk_object_arg_get(): %s", error);
834 arg->type = GTK_TYPE_INVALID;
839 if (! (info->arg_flags & GTK_ARG_READABLE))
841 g_warning ("gtk_object_arg_get(): argument \"%s\" is not readable",
843 arg->type = GTK_TYPE_INVALID;
847 oclass = gtk_type_class (info->class_type);
848 g_assert (oclass->get_arg != NULL);
849 arg->type = info->type;
850 oclass->get_arg (object, arg, info->arg_id);
854 gtk_object_add_arg_type (const char *arg_name,
859 g_return_if_fail (arg_name != NULL);
860 g_return_if_fail (arg_type > GTK_TYPE_NONE);
861 g_return_if_fail (arg_id > 0);
862 g_return_if_fail ((arg_flags & GTK_ARG_CHILD_ARG) == 0);
863 if (arg_flags & GTK_ARG_CONSTRUCT)
864 g_return_if_fail ((arg_flags & GTK_ARG_READWRITE) == GTK_ARG_READWRITE);
866 g_return_if_fail ((arg_flags & GTK_ARG_READWRITE) != 0);
868 if (!object_arg_info_ht)
869 object_arg_info_ht = g_hash_table_new (gtk_arg_info_hash,
872 gtk_arg_type_new_static (GTK_TYPE_OBJECT,
874 GTK_STRUCT_OFFSET (GtkObjectClass, n_args),
882 gtk_object_args_collect (GtkType object_type,
884 GSList **info_list_p,
885 const gchar *first_arg_name,
888 return gtk_args_collect (object_type,
897 gtk_object_arg_get_info (GtkType object_type,
898 const gchar *arg_name,
901 return gtk_arg_get_info (object_type,
908 gtk_object_query_args (GtkType class_type,
912 g_return_val_if_fail (n_args != NULL, NULL);
914 g_return_val_if_fail (GTK_FUNDAMENTAL_TYPE (class_type) == GTK_TYPE_OBJECT, NULL);
916 return gtk_args_query (class_type, object_arg_info_ht, arg_flags, n_args);
919 /*****************************************
920 * GtkObject object_data mechanism
922 *****************************************/
925 gtk_object_set_data_by_id (GtkObject *object,
929 g_return_if_fail (data_id > 0);
931 gtk_object_set_data_by_id_full (object, data_id, data, NULL);
935 gtk_object_set_data (GtkObject *object,
939 g_return_if_fail (key != NULL);
941 gtk_object_set_data_by_id_full (object, gtk_object_data_force_id (key), data, NULL);
945 gtk_object_set_data_by_id_full (GtkObject *object,
948 GtkDestroyNotify destroy)
950 GtkObjectData *odata;
952 g_return_if_fail (object != NULL);
953 g_return_if_fail (GTK_IS_OBJECT (object));
954 g_return_if_fail (data_id > 0);
956 odata = object->object_data;
965 if (odata->id == data_id)
968 prev->next = odata->next;
970 object->object_data = odata->next;
972 GTK_OBJECT_DATA_DESTROY (odata);
984 if (odata->id == data_id)
986 register GtkDestroyNotify dfunc;
987 register gpointer ddata;
989 dfunc = odata->destroy;
991 odata->destroy = destroy;
994 /* we need to have updated all structures prior to
995 * invokation of the destroy function
1003 odata = odata->next;
1006 if (gtk_object_data_free_list)
1008 odata = gtk_object_data_free_list;
1009 gtk_object_data_free_list = odata->next;
1013 GtkObjectData *odata_block;
1016 odata_block = g_new0 (GtkObjectData, GTK_OBJECT_DATA_BLOCK_SIZE);
1017 for (i = 1; i < GTK_OBJECT_DATA_BLOCK_SIZE; i++)
1019 (odata_block + i)->next = gtk_object_data_free_list;
1020 gtk_object_data_free_list = (odata_block + i);
1023 odata = odata_block;
1026 odata->id = data_id;
1028 odata->destroy = destroy;
1029 odata->next = object->object_data;
1031 object->object_data = odata;
1036 gtk_object_set_data_full (GtkObject *object,
1039 GtkDestroyNotify destroy)
1041 g_return_if_fail (key != NULL);
1043 gtk_object_set_data_by_id_full (object, gtk_object_data_force_id (key), data, destroy);
1047 gtk_object_get_data_by_id (GtkObject *object,
1050 GtkObjectData *odata;
1052 g_return_val_if_fail (object != NULL, NULL);
1053 g_return_val_if_fail (GTK_IS_OBJECT (object), NULL);
1057 odata = object->object_data;
1060 if (odata->id == data_id)
1062 odata = odata->next;
1070 gtk_object_get_data (GtkObject *object,
1075 g_return_val_if_fail (key != NULL, NULL);
1077 id = gtk_object_data_try_key (key);
1079 return gtk_object_get_data_by_id (object, id);
1085 gtk_object_remove_data_by_id (GtkObject *object,
1089 gtk_object_set_data_by_id_full (object, data_id, NULL, NULL);
1093 gtk_object_remove_data (GtkObject *object,
1098 g_return_if_fail (key != NULL);
1100 id = gtk_object_data_try_key (key);
1102 gtk_object_set_data_by_id_full (object, id, NULL, NULL);
1106 gtk_object_set_user_data (GtkObject *object,
1109 if (!user_data_key_id)
1110 user_data_key_id = g_quark_from_static_string (user_data_key);
1112 gtk_object_set_data_by_id_full (object, user_data_key_id, data, NULL);
1116 gtk_object_get_user_data (GtkObject *object)
1118 if (user_data_key_id)
1119 return gtk_object_get_data_by_id (object, user_data_key_id);
1124 /*******************************************
1125 * GtkObject referencing and unreferencing
1127 *******************************************/
1129 #undef gtk_object_ref
1130 #undef gtk_object_unref
1133 gtk_object_ref (GtkObject *object)
1135 g_return_if_fail (object != NULL);
1136 g_return_if_fail (GTK_IS_OBJECT (object));
1138 object->ref_count += 1;
1142 gtk_object_unref (GtkObject *object)
1144 g_return_if_fail (object != NULL);
1145 g_return_if_fail (GTK_IS_OBJECT (object));
1147 if (object->ref_count == 1)
1148 gtk_object_destroy (object);
1150 if (object->ref_count > 0)
1151 object->ref_count -= 1;
1153 if (object->ref_count == 0)
1155 #ifdef G_ENABLE_DEBUG
1156 if (gtk_debug_flags & GTK_DEBUG_OBJECTS)
1158 g_assert (g_hash_table_lookup (living_objs_ht, object) == object);
1159 g_hash_table_remove (living_objs_ht, object);
1162 #endif /* G_ENABLE_DEBUG */
1163 object->klass->finalize (object);
1167 static GtkObject *gtk_trace_object = NULL;
1169 gtk_trace_referencing (GtkObject *object,
1175 if (gtk_debug_flags & GTK_DEBUG_OBJECTS)
1177 gboolean exists = TRUE;
1179 g_return_if_fail (object != NULL);
1180 g_return_if_fail (GTK_IS_OBJECT (object));
1182 #ifdef G_ENABLE_DEBUG
1183 exists = g_hash_table_lookup (living_objs_ht, object) != NULL;
1184 #endif /* G_ENABLE_DEBUG */
1187 (object == gtk_trace_object ||
1188 gtk_trace_object == (void*)42))
1189 fprintf (stdout, "trace: object_%s: (%s:%p)->ref_count=%d %s (%s:%d)\n",
1190 do_ref ? "ref" : "unref",
1191 gtk_type_name (GTK_OBJECT_TYPE (object)),
1194 do_ref ? "+ 1" : "- 1",
1198 fprintf (stdout, "trace: object_%s(%p): no such object! (%s:%d)\n",
1199 do_ref ? "ref" : "unref",
1206 gtk_object_ref (object);
1208 gtk_object_unref (object);