1 /* GObject - GLib Type, Object, Parameter and Signal Library
2 * Copyright (C) 2000 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.
19 * this code is based on the original GtkSignal implementation
20 * for the Gtk+ library by Peter Mattis <petm@xcf.berkeley.edu>
26 #include "gbsearcharray.h"
29 /* pre allocation configurations
31 #define BSA_PRE_ALLOC (20)
32 #define HANDLER_PRE_ALLOC (48)
33 #define EMISSION_PRE_ALLOC (16)
35 #define TIGHT_MEMORY (1)
37 #define REPORT_BUG "please report occourance circumstances to gtk-devel-list@gnome.org"
40 /* --- generic allocation --- */
41 /* we can special case allocations generically by replacing
42 * these functions with more speed/memory aware variants
44 static inline gpointer
45 g_generic_node_alloc (GTrashStack **trash_stack_p,
47 guint nodes_pre_alloc)
49 gpointer node = g_trash_stack_pop (trash_stack_p);
55 nodes_pre_alloc = MAX (nodes_pre_alloc, 1);
56 block = g_malloc (sizeof_node * nodes_pre_alloc);
57 while (--nodes_pre_alloc)
59 g_trash_stack_push (trash_stack_p, block);
68 g_generic_node_free (GTrashStack **trash_stack_p,
71 g_trash_stack_push (trash_stack_p, node);
75 /* --- typedefs --- */
76 typedef struct _SignalNode SignalNode;
77 typedef struct _SignalKey SignalKey;
78 typedef struct _Emission Emission;
79 typedef struct _Handler Handler;
80 typedef struct _HandlerList HandlerList;
90 /* --- prototypes --- */
91 static inline guint signal_id_lookup (GQuark quark,
93 static void signal_destroy_R (SignalNode *signal_node);
94 static inline HandlerList* handler_list_ensure (guint signal_id,
96 static inline HandlerList* handler_list_lookup (guint signal_id,
98 static inline Handler* handler_new (gboolean after);
99 static void handler_insert (guint signal_id,
102 static Handler* handler_lookup (gpointer instance,
105 static Handler* handler_find (gpointer instance,
106 GSignalMatchType mask,
112 static inline void handler_ref (Handler *handler);
113 static inline void handler_unref_R (guint signal_id,
116 static inline void emission_push (Emission **emission_list_p,
120 EmissionState *state_p);
121 static inline void emission_pop (Emission **emission_list_p,
122 EmissionState *state_p);
123 static inline Emission* emission_find (Emission *emission_list,
127 static void signal_emit_R (SignalNode *node,
130 GValue *return_value,
131 const GValue *instance_and_params);
134 /* --- structures --- */
137 /* permanent portion */
143 /* reinitializable portion */
148 GClosure *class_closure;
149 GSignalAccumulator accumulator;
150 GSignalCMarshaller c_marshaller;
151 GHookList *emission_hooks;
167 EmissionState *state_p;
182 guint ref_count : 16;
183 #define HANDLER_MAX_REF_COUNT (1 << 16)
184 guint block_count : 12;
185 #define HANDLER_MAX_BLOCK_COUNT (1 << 12)
191 /* --- variables --- */
192 static GBSearchArray g_signal_key_bsa = { NULL, 0, 0, 0, NULL };
193 static GHashTable *g_handler_list_bsa_ht = NULL;
194 static Emission *g_recursive_emissions = NULL;
195 static Emission *g_restart_emissions = NULL;
196 static GTrashStack *g_bsa_ts = NULL;
197 static GTrashStack *g_handler_ts = NULL;
198 static GTrashStack *g_emission_ts = NULL;
199 G_LOCK_DEFINE_STATIC (g_signal_mutex);
202 /* --- signal nodes --- */
203 static guint g_n_signal_nodes = 0;
204 static SignalNode **g_signal_nodes = NULL;
206 static inline SignalNode*
207 LOOKUP_SIGNAL_NODE (register guint signal_id)
209 if (signal_id < g_n_signal_nodes)
210 return g_signal_nodes[signal_id];
216 /* --- functions --- */
218 signal_id_lookup (GQuark quark,
223 SignalKey key, *signal_key;
228 signal_key = g_bsearch_array_lookup (&g_signal_key_bsa, &key);
231 return signal_key->signal_id;
233 itype = g_type_parent (itype);
241 handler_lists_cmp (gconstpointer node1,
244 const HandlerList *hlist1 = node1, *hlist2 = node2;
246 return G_BSEARCH_ARRAY_CMP (hlist1->signal_id, hlist2->signal_id);
249 static inline HandlerList*
250 handler_list_ensure (guint signal_id,
253 GBSearchArray *hlbsa = g_hash_table_lookup (g_handler_list_bsa_ht, instance);
258 hlbsa = g_generic_node_alloc (&g_bsa_ts,
259 sizeof (GBSearchArray),
261 hlbsa->cmp_func = handler_lists_cmp;
262 hlbsa->sizeof_node = sizeof (HandlerList);
263 hlbsa->flags = G_BSEARCH_DEFER_SHRINK;
266 g_hash_table_insert (g_handler_list_bsa_ht, instance, hlbsa);
268 key.signal_id = signal_id;
271 return g_bsearch_array_insert (hlbsa, &key, FALSE);
274 static inline HandlerList*
275 handler_list_lookup (guint signal_id,
278 GBSearchArray *hlbsa = g_hash_table_lookup (g_handler_list_bsa_ht, instance);
281 key.signal_id = signal_id;
283 return hlbsa ? g_bsearch_array_lookup (hlbsa, &key) : NULL;
287 handler_lookup (gpointer instance,
291 GBSearchArray *hlbsa = g_hash_table_lookup (g_handler_list_bsa_ht, instance);
297 for (i = 0; i < hlbsa->n_nodes; i++)
299 HandlerList *hlist = g_bsearch_array_get_nth (hlbsa, i);
302 for (handler = hlist->handlers; handler; handler = handler->next)
303 if (handler->id == handler_id)
306 *signal_id_p = hlist->signal_id;
317 handler_find (gpointer instance,
318 GSignalMatchType mask,
325 if (mask & G_SIGNAL_MATCH_ID)
327 HandlerList *hlist = handler_list_lookup (signal_id, instance);
331 if (mask & G_SIGNAL_MATCH_FUNC)
333 node = LOOKUP_SIGNAL_NODE (signal_id);
334 if (!node || !node->c_marshaller)
339 for (handler = hlist ? hlist->handlers : NULL; handler; handler = handler->next)
340 if (((mask & G_SIGNAL_MATCH_DETAIL) || handler->detail == detail) &&
341 ((mask & G_SIGNAL_MATCH_CLOSURE) || handler->closure == closure) &&
342 ((mask & G_SIGNAL_MATCH_DATA) || handler->closure->data == data) &&
343 ((mask & G_SIGNAL_MATCH_UNBLOCKED) || handler->block_count == 0) &&
344 ((mask & G_SIGNAL_MATCH_FUNC) || (handler->closure->marshal == node->c_marshaller &&
345 handler->closure->meta_marshal == 0 &&
346 ((GCClosure*) handler->closure)->callback == func)))
351 GBSearchArray *hlbsa = g_hash_table_lookup (g_handler_list_bsa_ht, instance);
358 for (i = 0; i < hlbsa->n_nodes; i++)
360 HandlerList *hlist = g_bsearch_array_get_nth (hlbsa, i);
364 if (!(mask & G_SIGNAL_MATCH_FUNC))
366 node = LOOKUP_SIGNAL_NODE (hlist->signal_id);
367 if (!node->c_marshaller)
371 for (handler = hlist->handlers; handler; handler = handler->next)
372 if (((mask & G_SIGNAL_MATCH_DETAIL) || handler->detail == detail) &&
373 ((mask & G_SIGNAL_MATCH_CLOSURE) || handler->closure == closure) &&
374 ((mask & G_SIGNAL_MATCH_DATA) || handler->closure->data == data) &&
375 ((mask & G_SIGNAL_MATCH_UNBLOCKED) || handler->block_count == 0) &&
376 ((mask & G_SIGNAL_MATCH_FUNC) || (handler->closure->marshal == node->c_marshaller &&
377 handler->closure->meta_marshal == 0 &&
378 ((GCClosure*) handler->closure)->callback == func)))
387 static inline Handler*
388 handler_new (gboolean after)
390 static guint handler_id = 1;
391 Handler *handler = g_generic_node_alloc (&g_handler_ts,
394 #ifndef G_DISABLE_CHECKS
396 g_error (G_STRLOC ": handler id overflow, %s", REPORT_BUG);
399 handler->id = handler_id++;
400 handler->prev = NULL;
401 handler->next = NULL;
403 handler->ref_count = 1;
404 handler->block_count = 0;
405 handler->after = after != FALSE;
406 handler->closure = NULL;
412 handler_ref (Handler *handler)
414 g_return_if_fail (handler->ref_count > 0);
416 #ifndef G_DISABLE_CHECKS
417 if (handler->ref_count >= HANDLER_MAX_REF_COUNT - 1)
418 g_error (G_STRLOC ": handler ref_count overflow, %s", REPORT_BUG);
421 handler->ref_count += 1;
425 handler_unref_R (guint signal_id,
429 g_return_if_fail (handler->ref_count > 0);
431 handler->ref_count -= 1;
432 if (!handler->ref_count)
435 handler->next->prev = handler->prev;
436 if (handler->prev) /* watch out for g_signal_handlers_destroy()! */
437 handler->prev->next = handler->next;
440 HandlerList *hlist = handler_list_lookup (signal_id, instance);
442 hlist->handlers = handler->next;
444 G_UNLOCK (g_signal_mutex);
445 g_closure_unref (handler->closure);
446 G_LOCK (g_signal_mutex);
447 g_generic_node_free (&g_handler_ts, handler);
452 handler_insert (guint signal_id,
458 g_assert (handler->prev == NULL && handler->next == NULL); // FIXME: paranoid
460 hlist = handler_list_ensure (signal_id, instance);
461 if (!hlist->handlers)
462 hlist->handlers = handler;
463 else if (hlist->handlers->after && !handler->after)
465 handler->next = hlist->handlers;
466 hlist->handlers->prev = handler;
467 hlist->handlers = handler;
471 Handler *tmp = hlist->handlers;
477 while (tmp->next && !tmp->next->after)
480 tmp->next->prev = handler;
481 handler->next = tmp->next;
488 emission_push (Emission **emission_list_p,
492 EmissionState *state_p)
494 Emission *emission = g_generic_node_alloc (&g_emission_ts,
497 emission->next = *emission_list_p;
498 emission->signal_id = signal_id;
499 emission->detail = detail;
500 emission->instance = instance;
501 emission->state_p = state_p;
502 *emission_list_p = emission;
506 emission_pop (Emission **emission_list_p,
507 EmissionState *state_p)
509 Emission **loc = emission_list_p, *emission = *loc;
511 while (emission->state_p != state_p)
513 loc = &emission->next;
516 *loc = emission->next;
517 g_generic_node_free (&g_emission_ts, emission);
520 static inline Emission*
521 emission_find (Emission *emission_list,
528 for (emission = emission_list; emission; emission = emission->next)
529 if (emission->instance == instance &&
530 emission->signal_id == signal_id &&
531 emission->detail == detail)
537 signal_key_cmp (gconstpointer node1,
540 const SignalKey *key1 = node1, *key2 = node2;
542 if (key1->itype == key2->itype)
543 return G_BSEARCH_ARRAY_CMP (key1->quark, key2->quark);
545 return G_BSEARCH_ARRAY_CMP (key1->itype, key2->itype);
549 g_signal_init (void) /* sync with gtype.c */
551 G_LOCK (g_signal_mutex);
552 if (!g_n_signal_nodes)
554 /* setup signal key array */
555 g_signal_key_bsa.cmp_func = signal_key_cmp;
556 g_signal_key_bsa.sizeof_node = sizeof (SignalKey);
557 g_signal_key_bsa.flags = 0; /* alloc-only */
559 /* setup handler list binary searchable array hash table (in german, that'd be one word ;) */
560 g_handler_list_bsa_ht = g_hash_table_new (g_direct_hash, NULL);
562 /* invalid (0) signal_id */
563 g_n_signal_nodes = 1;
564 g_signal_nodes = g_renew (SignalNode*, g_signal_nodes, g_n_signal_nodes);
565 g_signal_nodes[0] = NULL;
567 G_UNLOCK (g_signal_mutex);
571 g_signals_destroy (GType itype)
575 G_LOCK (g_signal_mutex);
576 for (i = 0; i < g_n_signal_nodes; i++)
578 SignalNode *node = g_signal_nodes[i];
580 if (node->itype == itype)
583 g_warning (G_STRLOC ": signal \"%s\" of type `%s' already destroyed",
585 g_type_name (node->itype));
587 signal_destroy_R (node);
590 G_UNLOCK (g_signal_mutex);
594 g_signal_stop_emission (gpointer instance,
600 g_return_if_fail (G_TYPE_CHECK_INSTANCE (instance));
601 g_return_if_fail (signal_id > 0);
603 G_LOCK (g_signal_mutex);
604 node = LOOKUP_SIGNAL_NODE (signal_id);
605 if (node && detail && !(node->flags & G_SIGNAL_DETAILED))
607 g_warning ("%s: signal id `%u' does not support detail (%u)", G_STRLOC, signal_id, detail);
608 G_UNLOCK (g_signal_mutex);
611 if (node && g_type_conforms_to (G_TYPE_FROM_INSTANCE (instance), node->itype))
613 Emission *emission_list = node->flags & G_SIGNAL_NO_RECURSE ? g_restart_emissions : g_recursive_emissions;
614 Emission *emission = emission_find (emission_list, signal_id, detail, instance);
618 if (*emission->state_p == EMISSION_HOOK)
619 g_warning (G_STRLOC ": emission of signal \"%s\" for instance `%p' cannot be stopped from emission hook",
620 node->name, instance);
621 else if (*emission->state_p == EMISSION_RUN)
622 *emission->state_p = EMISSION_STOP;
625 g_warning (G_STRLOC ": no emission of signal \"%s\" to stop for instance `%p'",
626 node->name, instance);
629 g_warning ("%s: signal id `%u' is invalid for instance `%p'", G_STRLOC, signal_id, instance);
630 G_UNLOCK (g_signal_mutex);
634 g_signal_lookup (const gchar *name,
639 g_return_val_if_fail (name != NULL, 0);
640 g_return_val_if_fail (G_TYPE_IS_INSTANTIATABLE (itype) || G_TYPE_IS_INTERFACE (itype), 0);
642 G_LOCK (g_signal_mutex);
643 signal_id = signal_id_lookup (g_quark_try_string (name), itype);
644 G_UNLOCK (g_signal_mutex);
650 g_signal_name (guint signal_id)
655 G_LOCK (g_signal_mutex);
656 node = LOOKUP_SIGNAL_NODE (signal_id);
657 name = node ? node->name : NULL;
658 G_UNLOCK (g_signal_mutex);
664 g_signal_query (guint signal_id,
669 g_return_if_fail (query != NULL);
671 G_LOCK (g_signal_mutex);
672 node = LOOKUP_SIGNAL_NODE (signal_id);
673 if (!node || node->destroyed)
674 query->signal_id = 0;
677 query->signal_id = node->signal_id;
678 query->signal_name = node->name;
679 query->itype = node->itype;
680 query->signal_flags = node->flags;
681 query->return_type = node->return_type;
682 query->n_params = node->n_params;
683 query->param_types = node->param_types;
685 G_UNLOCK (g_signal_mutex);
689 g_signal_list_ids (GType itype,
697 g_return_val_if_fail (G_TYPE_IS_INSTANTIATABLE (itype) || G_TYPE_IS_INTERFACE (itype), NULL);
698 g_return_val_if_fail (n_ids != NULL, NULL);
700 G_LOCK (g_signal_mutex);
702 keys = g_signal_key_bsa.nodes;
703 n_nodes = g_signal_key_bsa.n_nodes;
704 result = g_array_new (FALSE, FALSE, sizeof (guint));
706 for (i = 0; i < n_nodes; i++)
707 if (keys[i].itype == itype)
709 gchar *name = g_quark_to_string (keys[i].quark);
711 /* Signal names with "_" in them are aliases to the same
712 * name with "-" instead of "_".
714 if (!strchr (name, '_'))
715 g_array_append_val (result, keys[i].signal_id);
718 *n_ids = result->len;
720 G_UNLOCK (g_signal_mutex);
722 return (guint *) g_array_free (result, FALSE);
726 g_signal_newv (const gchar *signal_name,
728 GSignalFlags signal_flags,
729 GClosure *class_closure,
730 GSignalAccumulator accumulator,
731 GSignalCMarshaller c_marshaller,
740 g_return_val_if_fail (signal_name != NULL, 0);
741 g_return_val_if_fail (G_TYPE_IS_INSTANTIATABLE (itype) || G_TYPE_IS_INTERFACE (itype), 0);
743 g_return_val_if_fail (param_types != NULL, 0);
744 if (return_type != G_TYPE_NONE)
745 g_return_val_if_fail (accumulator == NULL, 0);
747 name = g_strdup (signal_name);
748 g_strdelimit (name, G_STR_DELIMITERS ":^", '_'); // FIXME do character checks like for types
750 G_LOCK (g_signal_mutex);
752 signal_id = signal_id_lookup (g_quark_try_string (name), itype);
753 node = LOOKUP_SIGNAL_NODE (signal_id);
754 if (node && !node->destroyed)
756 g_warning (G_STRLOC ": signal \"%s\" already exists in the `%s' %s",
758 g_type_name (node->itype),
759 G_TYPE_IS_INTERFACE (node->itype) ? "interface" : "class ancestry");
761 G_UNLOCK (g_signal_mutex);
764 if (node && node->itype != itype)
766 g_warning (G_STRLOC ": signal \"%s\" for type `%s' was previously created for type `%s'",
769 g_type_name (node->itype));
771 G_UNLOCK (g_signal_mutex);
774 for (i = 0; i < n_params; i++)
775 if (!G_TYPE_IS_VALUE (param_types[i]) ||
776 param_types[i] == G_TYPE_ENUM || param_types[i] == G_TYPE_FLAGS) /* FIXME: kludge */
778 g_warning (G_STRLOC ": parameter %d of type `%s' for signal \"%s::%s\" is not a value type",
779 i + 1, g_type_name (param_types[i]), g_type_name (itype), name);
781 G_UNLOCK (g_signal_mutex);
784 if (return_type != G_TYPE_NONE && !G_TYPE_IS_VALUE (return_type))
786 g_warning (G_STRLOC ": return value of type `%s' for signal \"%s::%s\" is not a value type",
787 g_type_name (param_types[i]), g_type_name (itype), name);
789 G_UNLOCK (g_signal_mutex);
793 /* setup permanent portion of signal node */
798 signal_id = g_n_signal_nodes++;
799 node = g_new (SignalNode, 1);
800 node->signal_id = signal_id;
801 g_signal_nodes = g_renew (SignalNode*, g_signal_nodes, g_n_signal_nodes);
802 g_signal_nodes[signal_id] = node;
806 key.quark = g_quark_from_string (node->name);
807 key.signal_id = signal_id;
808 g_bsearch_array_insert (&g_signal_key_bsa, &key, FALSE);
809 g_strdelimit (node->name, "_", '-');
810 key.quark = g_quark_from_static_string (node->name);
811 g_bsearch_array_insert (&g_signal_key_bsa, &key, FALSE);
813 node->destroyed = FALSE;
815 /* setup reinitializable portion */
816 node->flags = signal_flags & G_SIGNAL_FLAGS_MASK;
817 node->n_params = n_params;
818 node->param_types = g_memdup (param_types, sizeof (GType) * n_params);
819 node->return_type = return_type;
820 node->class_closure = class_closure ? g_closure_ref (class_closure) : NULL;
821 node->accumulator = accumulator;
822 node->c_marshaller = c_marshaller;
823 node->emission_hooks = NULL;
824 if (node->c_marshaller && class_closure && G_CLOSURE_NEEDS_MARSHAL (class_closure))
825 g_closure_set_marshal (class_closure, node->c_marshaller);
827 G_UNLOCK (g_signal_mutex);
832 signal_destroy_R (SignalNode *signal_node)
834 SignalNode node = *signal_node;
836 signal_node->destroyed = TRUE;
838 /* reentrancy caution, zero out real contents first */
839 signal_node->n_params = 0;
840 signal_node->param_types = NULL;
841 signal_node->return_type = 0;
842 signal_node->class_closure = NULL;
843 signal_node->accumulator = NULL;
844 signal_node->c_marshaller = NULL;
845 signal_node->emission_hooks = NULL;
847 #ifndef G_DISABLE_CHECKS
848 /* check current emissions */
852 for (emission = (node.flags & G_SIGNAL_NO_RECURSE) ? g_restart_emissions : g_recursive_emissions;
853 emission; emission = emission->next)
854 if (emission->signal_id == node.signal_id)
855 g_critical (G_STRLOC ": signal \"%s\" being destroyed is currently in emission (instance `%p')",
856 node.name, emission->instance);
860 /* free contents that need to
862 G_UNLOCK (g_signal_mutex);
863 g_free (node.param_types);
864 g_closure_unref (node.class_closure);
865 if (node.emission_hooks)
867 g_hook_list_clear (node.emission_hooks);
868 g_free (node.emission_hooks);
870 G_LOCK (g_signal_mutex);
874 g_signal_connect_closure (gpointer instance,
881 guint handler_id = 0;
883 g_return_val_if_fail (G_TYPE_CHECK_INSTANCE (instance), 0);
884 g_return_val_if_fail (signal_id > 0, 0);
885 g_return_val_if_fail (closure != NULL, 0);
887 G_LOCK (g_signal_mutex);
888 node = LOOKUP_SIGNAL_NODE (signal_id);
889 if (node && detail && !(node->flags & G_SIGNAL_DETAILED))
891 g_warning ("%s: signal id `%u' does not support detail (%u)", G_STRLOC, signal_id, detail);
892 G_UNLOCK (g_signal_mutex);
895 if (node && g_type_conforms_to (G_TYPE_FROM_INSTANCE (instance), node->itype))
897 Handler *handler = handler_new (after);
899 handler_id = handler->id;
900 handler->detail = detail;
901 handler->closure = g_closure_ref (closure);
902 handler_insert (signal_id, instance, handler);
903 if (node->c_marshaller && G_CLOSURE_NEEDS_MARSHAL (closure))
904 g_closure_set_marshal (closure, node->c_marshaller);
907 g_warning ("%s: signal id `%u' is invalid for instance `%p'", G_STRLOC, signal_id, instance);
908 G_UNLOCK (g_signal_mutex);
914 g_signal_handler_block (gpointer instance,
919 g_return_if_fail (G_TYPE_CHECK_INSTANCE (instance));
920 g_return_if_fail (handler_id > 0);
922 G_LOCK (g_signal_mutex);
923 handler = handler_lookup (instance, handler_id, NULL);
926 #ifndef G_DISABLE_CHECKS
927 if (handler->block_count >= HANDLER_MAX_BLOCK_COUNT - 1)
928 g_error (G_STRLOC ": handler block_count overflow, %s", REPORT_BUG);
931 handler->block_count += 1;
934 g_warning ("%s: instance `%p' has no handler with id `%u'", G_STRLOC, instance, handler_id);
935 G_UNLOCK (g_signal_mutex);
939 g_signal_handler_unblock (gpointer instance,
944 g_return_if_fail (G_TYPE_CHECK_INSTANCE (instance));
945 g_return_if_fail (handler_id > 0);
947 G_LOCK (g_signal_mutex);
948 handler = handler_lookup (instance, handler_id, NULL);
951 if (handler->block_count)
952 handler->block_count -= 1;
954 g_warning (G_STRLOC ": handler `%u' of instance `%p' is not blocked", handler_id, instance);
957 g_warning ("%s: instance `%p' has no handler with id `%u'", G_STRLOC, instance, handler_id);
958 G_UNLOCK (g_signal_mutex);
962 g_signal_handler_disconnect (gpointer instance,
968 g_return_if_fail (G_TYPE_CHECK_INSTANCE (instance));
969 g_return_if_fail (handler_id > 0);
971 G_LOCK (g_signal_mutex);
972 handler = handler_lookup (instance, handler_id, &signal_id);
976 handler->block_count = 1;
977 handler_unref_R (signal_id, instance, handler);
980 g_warning ("%s: instance `%p' has no handler with id `%u'", G_STRLOC, instance, handler_id);
981 G_UNLOCK (g_signal_mutex);
985 g_signal_handlers_destroy (gpointer instance)
987 GBSearchArray *hlbsa;
989 g_return_if_fail (G_TYPE_CHECK_INSTANCE (instance));
991 G_LOCK (g_signal_mutex);
992 hlbsa = g_hash_table_lookup (g_handler_list_bsa_ht, instance);
997 /* reentrancy caution, delete instance trace first */
998 g_hash_table_remove (g_handler_list_bsa_ht, instance);
1000 for (i = 0; i < hlbsa->n_nodes; i++)
1002 HandlerList *hlist = g_bsearch_array_get_nth (hlbsa, i);
1003 Handler *handler = hlist->handlers;
1007 Handler *tmp = handler;
1009 handler = tmp->next;
1010 tmp->block_count = 1;
1011 /* cruel unlink, this works because _all_ handlers vanish */
1017 handler_unref_R (0, NULL, tmp);
1021 g_free (hlbsa->nodes);
1022 g_generic_node_free (&g_bsa_ts, hlbsa);
1024 G_UNLOCK (g_signal_mutex);
1028 g_signal_handler_find (gpointer instance,
1029 GSignalMatchType mask,
1037 guint handler_id = 0;
1039 g_return_val_if_fail (G_TYPE_CHECK_INSTANCE (instance), 0);
1040 g_return_val_if_fail ((mask & ~G_SIGNAL_MATCH_MASK) == 0, 0);
1042 if (mask & G_SIGNAL_MATCH_MASK)
1044 G_LOCK (g_signal_mutex);
1045 handler = handler_find (instance, mask, signal_id, detail, closure, func, data);
1046 handler_id = handler ? handler->id : 0;
1047 G_UNLOCK (g_signal_mutex);
1054 signal_handlers_foreach_matched (gpointer instance,
1055 GSignalMatchType mask,
1061 void (*callback) (gpointer instance,
1065 guint n_handlers = 0;
1067 handler = handler_find (instance, mask, signal_id, detail, closure, func, data);
1068 while (handler && handler->id)
1071 G_UNLOCK (g_signal_mutex);
1072 callback (instance, handler->id);
1073 G_LOCK (g_signal_mutex);
1074 /* need constant relookups due to callback */
1075 handler = handler_find (instance, mask, signal_id, detail, closure, func, data);
1082 g_signal_handlers_block_matched (gpointer instance,
1083 GSignalMatchType mask,
1090 guint n_handlers = 0;
1092 g_return_val_if_fail (G_TYPE_CHECK_INSTANCE (instance), FALSE);
1093 g_return_val_if_fail ((mask & ~G_SIGNAL_MATCH_MASK) == 0, FALSE);
1095 if (mask & (G_SIGNAL_MATCH_CLOSURE | G_SIGNAL_MATCH_FUNC | G_SIGNAL_MATCH_DATA))
1097 G_LOCK (g_signal_mutex);
1098 n_handlers = signal_handlers_foreach_matched (instance, mask, signal_id, detail,
1099 closure, func, data,
1100 g_signal_handler_block);
1101 G_UNLOCK (g_signal_mutex);
1108 g_signal_handlers_unblock_matched (gpointer instance,
1109 GSignalMatchType mask,
1116 guint n_handlers = 0;
1118 g_return_val_if_fail (G_TYPE_CHECK_INSTANCE (instance), FALSE);
1119 g_return_val_if_fail ((mask & ~G_SIGNAL_MATCH_MASK) == 0, FALSE);
1121 if (mask & (G_SIGNAL_MATCH_CLOSURE | G_SIGNAL_MATCH_FUNC | G_SIGNAL_MATCH_DATA))
1123 G_LOCK (g_signal_mutex);
1124 n_handlers = signal_handlers_foreach_matched (instance, mask, signal_id, detail,
1125 closure, func, data,
1126 g_signal_handler_unblock);
1127 G_UNLOCK (g_signal_mutex);
1134 g_signal_handlers_disconnect_matched (gpointer instance,
1135 GSignalMatchType mask,
1142 guint n_handlers = 0;
1144 g_return_val_if_fail (G_TYPE_CHECK_INSTANCE (instance), FALSE);
1145 g_return_val_if_fail ((mask & ~G_SIGNAL_MATCH_MASK) == 0, FALSE);
1147 if (mask & (G_SIGNAL_MATCH_CLOSURE | G_SIGNAL_MATCH_FUNC | G_SIGNAL_MATCH_DATA))
1149 G_LOCK (g_signal_mutex);
1150 n_handlers = signal_handlers_foreach_matched (instance, mask, signal_id, detail,
1151 closure, func, data,
1152 g_signal_handler_disconnect);
1153 G_UNLOCK (g_signal_mutex);
1160 g_signal_has_handler_pending (gpointer instance,
1163 gboolean may_be_blocked)
1165 Handler *handler = NULL;
1167 g_return_val_if_fail (G_TYPE_CHECK_INSTANCE (instance), FALSE);
1168 g_return_val_if_fail (signal_id > 0, FALSE);
1170 G_LOCK (g_signal_mutex);
1173 SignalNode *node = LOOKUP_SIGNAL_NODE (signal_id);
1175 if (!(node->flags & G_SIGNAL_DETAILED))
1177 g_warning ("%s: signal id `%u' does not support detail (%u)", G_STRLOC, signal_id, detail);
1178 G_UNLOCK (g_signal_mutex);
1182 handler = handler_find (instance,
1183 (G_SIGNAL_MATCH_ID | G_SIGNAL_MATCH_DETAIL |
1184 (may_be_blocked ? 0 : G_SIGNAL_MATCH_UNBLOCKED)),
1185 signal_id, detail, NULL, NULL, NULL);
1186 G_UNLOCK (g_signal_mutex);
1188 return handler != NULL;
1192 g_signal_emitv (const GValue *instance_and_params,
1195 GValue *return_value)
1199 const GValue *param_values;
1202 g_return_if_fail (instance_and_params != NULL);
1203 instance = g_value_get_as_pointer (instance_and_params);
1204 g_return_if_fail (G_TYPE_CHECK_INSTANCE (instance));
1205 g_return_if_fail (signal_id > 0);
1207 param_values = instance_and_params + 1;
1209 G_LOCK (g_signal_mutex);
1210 node = LOOKUP_SIGNAL_NODE (signal_id);
1211 #ifndef G_DISABLE_CHECKS
1212 if (!node || !g_type_conforms_to (G_TYPE_FROM_INSTANCE (instance), node->itype))
1214 g_warning ("%s: signal id `%u' is invalid for instance `%p'", G_STRLOC, signal_id, instance);
1215 G_UNLOCK (g_signal_mutex);
1218 if (detail && !(node->flags & G_SIGNAL_DETAILED))
1220 g_warning ("%s: signal id `%u' does not support detail (%u)", G_STRLOC, signal_id, detail);
1221 G_UNLOCK (g_signal_mutex);
1224 for (i = 0; i < node->n_params; i++)
1225 if (!G_VALUE_HOLDS (param_values + i, node->param_types[i]))
1227 g_critical (G_STRLOC ": value for `%s' parameter %u for signal \"%s\" is of type `%s'",
1228 g_type_name (node->param_types[i]),
1231 G_VALUE_TYPE_NAME (param_values + i));
1232 G_UNLOCK (g_signal_mutex);
1235 if (node->return_type != G_TYPE_NONE)
1239 g_critical (G_STRLOC ": return value `%s' for signal \"%s\" is (NULL)",
1240 g_type_name (node->return_type),
1242 G_UNLOCK (g_signal_mutex);
1245 else if (!node->accumulator && !G_VALUE_HOLDS (return_value, node->return_type))
1247 g_critical (G_STRLOC ": return value `%s' for signal \"%s\" is of type `%s'",
1248 g_type_name (node->return_type),
1250 G_VALUE_TYPE_NAME (return_value));
1251 G_UNLOCK (g_signal_mutex);
1256 return_value = NULL;
1257 #endif /* !G_DISABLE_CHECKS */
1259 signal_emit_R (node, detail, instance, return_value, instance_and_params);
1261 G_UNLOCK (g_signal_mutex);
1265 signal_emit_R (SignalNode *node,
1268 GValue *return_value,
1269 const GValue *instance_and_params)
1271 EmissionState emission_state = 0;
1272 GSignalAccumulator accumulator;
1273 GSignalInvocationHint ihint;
1274 GClosure *class_closure;
1276 Handler *handler_list = NULL;
1278 gboolean accu_used = FALSE;
1279 guint signal_id = node->signal_id;
1281 if (node->flags & G_SIGNAL_NO_RECURSE)
1283 Emission *emission = emission_find (g_restart_emissions, signal_id, detail, instance);
1287 *emission->state_p = EMISSION_RESTART;
1291 ihint.signal_id = node->signal_id;
1292 ihint.detail = detail;
1293 accumulator = node->accumulator;
1296 G_UNLOCK (g_signal_mutex);
1297 g_value_init (&accu, node->return_type);
1298 G_LOCK (g_signal_mutex);
1300 emission_push ((node->flags & G_SIGNAL_NO_RECURSE) ? &g_restart_emissions : &g_recursive_emissions,
1301 signal_id, detail, instance, &emission_state);
1302 class_closure = node->class_closure;
1307 handler_unref_R (signal_id, instance, handler_list);
1308 hlist = handler_list_lookup (signal_id, instance);
1309 handler_list = hlist ? hlist->handlers : NULL;
1311 handler_ref (handler_list);
1313 ihint.run_type = G_SIGNAL_RUN_FIRST;
1315 if ((node->flags & G_SIGNAL_RUN_FIRST) && class_closure)
1317 emission_state = EMISSION_RUN;
1319 G_UNLOCK (g_signal_mutex);
1323 g_value_reset (&accu);
1324 g_closure_invoke (class_closure,
1327 instance_and_params,
1329 if (!accumulator (&ihint, return_value, &accu) &&
1330 emission_state == EMISSION_RUN)
1331 emission_state = EMISSION_STOP;
1335 g_closure_invoke (class_closure,
1338 instance_and_params,
1340 G_LOCK (g_signal_mutex);
1342 if (emission_state == EMISSION_STOP)
1344 else if (emission_state == EMISSION_RESTART)
1348 if (node->emission_hooks)
1350 emission_state = EMISSION_HOOK;
1352 G_UNLOCK (g_signal_mutex);
1353 g_print ("emission_hooks()\n");
1354 G_LOCK (g_signal_mutex);
1356 if (emission_state == EMISSION_RESTART)
1362 Handler *handler = handler_list;
1364 emission_state = EMISSION_RUN;
1365 handler_ref (handler);
1372 handler_unref_R (signal_id, instance, handler_list);
1373 handler_list = handler;
1376 else if (!handler->block_count && (!handler->detail || handler->detail == detail))
1378 G_UNLOCK (g_signal_mutex);
1382 g_value_reset (&accu);
1383 g_closure_invoke (handler->closure,
1386 instance_and_params,
1388 if (!accumulator (&ihint, return_value, &accu) &&
1389 emission_state == EMISSION_RUN)
1390 emission_state = EMISSION_STOP;
1394 g_closure_invoke (handler->closure,
1397 instance_and_params,
1399 G_LOCK (g_signal_mutex);
1401 tmp = emission_state == EMISSION_RUN ? handler->next : NULL;
1404 tmp = handler->next;
1408 handler_unref_R (signal_id, instance, handler_list);
1409 handler_list = handler;
1414 if (emission_state == EMISSION_STOP)
1416 else if (emission_state == EMISSION_RESTART)
1420 ihint.run_type = G_SIGNAL_RUN_LAST;
1422 if ((node->flags & G_SIGNAL_RUN_LAST) && class_closure)
1424 emission_state = EMISSION_RUN;
1426 G_UNLOCK (g_signal_mutex);
1430 g_value_reset (&accu);
1431 g_closure_invoke (class_closure,
1434 instance_and_params,
1436 if (!accumulator (&ihint, return_value, &accu) &&
1437 emission_state == EMISSION_RUN)
1438 emission_state = EMISSION_STOP;
1442 g_closure_invoke (class_closure,
1445 instance_and_params,
1447 G_LOCK (g_signal_mutex);
1449 if (emission_state == EMISSION_STOP)
1451 else if (emission_state == EMISSION_RESTART)
1457 Handler *handler = handler_list;
1459 emission_state = EMISSION_RUN;
1460 handler_ref (handler);
1465 if (handler->after && !handler->block_count && (!handler->detail || handler->detail == detail))
1467 G_UNLOCK (g_signal_mutex);
1471 g_value_reset (&accu);
1472 g_closure_invoke (handler->closure,
1475 instance_and_params,
1477 if (!accumulator (&ihint, return_value, &accu) &&
1478 emission_state == EMISSION_RUN)
1479 emission_state = EMISSION_STOP;
1483 g_closure_invoke (handler->closure,
1486 instance_and_params,
1488 G_LOCK (g_signal_mutex);
1490 tmp = emission_state == EMISSION_RUN ? handler->next : NULL;
1493 tmp = handler->next;
1497 handler_unref_R (signal_id, instance, handler);
1502 if (emission_state == EMISSION_STOP)
1504 else if (emission_state == EMISSION_RESTART)
1510 ihint.run_type = G_SIGNAL_RUN_CLEANUP;
1512 if ((node->flags & G_SIGNAL_RUN_CLEANUP) && class_closure)
1514 gboolean need_unset = FALSE;
1516 emission_state = EMISSION_STOP;
1518 G_UNLOCK (g_signal_mutex);
1519 if (node->return_type != G_TYPE_NONE)
1523 g_value_init (&accu, node->return_type);
1527 g_value_reset (&accu);
1529 g_closure_invoke (class_closure,
1530 node->return_type != G_TYPE_NONE ? &accu : NULL,
1532 instance_and_params,
1535 g_value_unset (&accu);
1536 G_LOCK (g_signal_mutex);
1538 if (emission_state == EMISSION_RESTART)
1543 handler_unref_R (signal_id, instance, handler_list);
1545 emission_pop ((node->flags & G_SIGNAL_NO_RECURSE) ? &g_restart_emissions : &g_recursive_emissions, &emission_state);
1548 G_UNLOCK (g_signal_mutex);
1549 g_value_unset (&accu);
1550 G_LOCK (g_signal_mutex);