gobject/gsignal.c

   1 /* GObject - GLib Type, Object, Parameter and Signal Library
   2  * Copyright (C) 2000-2001 Red Hat, Inc.
   3  *
   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.
   8  *
   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.
  13  *
  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.
  18  *
  19  * this code is based on the original GtkSignal implementation
  20  * for the Gtk+ library by Peter Mattis <petm@xcf.berkeley.edu>
  21  */
  22
  23 /*
  24  * MT safe
  25  */
  26
  27 #include        "gsignal.h"
  28 #include        "gbsearcharray.h"
  29 #include        "gvaluecollector.h"
  30 #include        "gvaluetypes.h"
  31 #include        "gboxed.h"
  32 #include        <string.h>
  33
  34
  35 /* pre allocation configurations
  36  */
  37 #define MAX_STACK_VALUES        (16)
  38 #define HANDLER_PRE_ALLOC       (48)
  39 #define EMISSION_PRE_ALLOC      (16)
  40
  41 #define REPORT_BUG      "please report occourance circumstances to gtk-devel-list@gnome.org"
  42 #ifdef  G_ENABLE_DEBUG
  43 #define IF_DEBUG(debug_type, cond)      if ((_g_type_debug_flags & G_TYPE_DEBUG_ ## debug_type) || cond)
  44 static volatile gpointer *g_trace_instance_signals = NULL;
  45 static volatile gpointer *g_trap_instance_signals = NULL;
  46 #endif  /* G_ENABLE_DEBUG */
  47
  48
  49 /* --- generic allocation --- */
  50 /* we special case allocations generically by replacing
  51  * these functions with more speed/memory aware variants
  52  */
  53 #ifndef DISABLE_MEM_POOLS
  54 static inline gpointer
  55 g_generic_node_alloc (GTrashStack **trash_stack_p,
  56                       guint         sizeof_node,
  57                       guint         nodes_pre_alloc)
  58 {
  59   gpointer node = g_trash_stack_pop (trash_stack_p);
  60
  61   if (!node)
  62     {
  63       guint8 *block;
  64
  65       nodes_pre_alloc = MAX (nodes_pre_alloc, 1);
  66       block = g_malloc (sizeof_node * nodes_pre_alloc);
  67       while (--nodes_pre_alloc)
  68         {
  69           g_trash_stack_push (trash_stack_p, block);
  70           block += sizeof_node;
  71         }
  72       node = block;
  73     }
  74
  75   return node;
  76 }
  77 #define g_generic_node_free(trash_stack_p, node) g_trash_stack_push (trash_stack_p, node)
  78 #else   /* !DISABLE_MEM_POOLS */
  79 #define g_generic_node_alloc(t,sizeof_node,p)    g_malloc (sizeof_node)
  80 #define g_generic_node_free(t,node)              g_free (node)
  81 #endif  /* !DISABLE_MEM_POOLS */
  82
  83
  84 /* --- typedefs --- */
  85 typedef struct _SignalNode   SignalNode;
  86 typedef struct _SignalKey    SignalKey;
  87 typedef struct _Emission     Emission;
  88 typedef struct _Handler      Handler;
  89 typedef struct _HandlerList  HandlerList;
  90 typedef struct _HandlerMatch HandlerMatch;
  91 typedef enum
  92 {
  93   EMISSION_STOP,
  94   EMISSION_RUN,
  95   EMISSION_HOOK,
  96   EMISSION_RESTART
  97 } EmissionState;
  98
  99
 100 /* --- prototypes --- */
 101 static inline guint             signal_id_lookup        (GQuark           quark,
 102                                                          GType            itype);
 103 static        void              signal_destroy_R        (SignalNode      *signal_node);
 104 static inline HandlerList*      handler_list_ensure     (guint            signal_id,
 105                                                          gpointer         instance);
 106 static inline HandlerList*      handler_list_lookup     (guint            signal_id,
 107                                                          gpointer         instance);
 108 static inline Handler*          handler_new             (gboolean         after);
 109 static        void              handler_insert          (guint            signal_id,
 110                                                          gpointer         instance,
 111                                                          Handler         *handler);
 112 static        Handler*          handler_lookup          (gpointer         instance,
 113                                                          gulong           handler_id,
 114                                                          guint           *signal_id_p);
 115 static inline HandlerMatch*     handler_match_prepend   (HandlerMatch    *list,
 116                                                          Handler         *handler,
 117                                                          guint            signal_id);
 118 static inline HandlerMatch*     handler_match_free1_R   (HandlerMatch    *node,
 119                                                          gpointer         instance);
 120 static        HandlerMatch*     handlers_find           (gpointer         instance,
 121                                                          GSignalMatchType mask,
 122                                                          guint            signal_id,
 123                                                          GQuark           detail,
 124                                                          GClosure        *closure,
 125                                                          gpointer         func,
 126                                                          gpointer         data,
 127                                                          gboolean         one_and_only);
 128 static inline void              handler_ref             (Handler         *handler);
 129 static inline void              handler_unref_R         (guint            signal_id,
 130                                                          gpointer         instance,
 131                                                          Handler         *handler);
 132 static inline void              emission_push           (Emission       **emission_list_p,
 133                                                          guint            signal_id,
 134                                                          GQuark           detail,
 135                                                          gpointer         instance,
 136                                                          EmissionState   *state_p);
 137 static inline void              emission_pop            (Emission       **emission_list_p,
 138                                                          EmissionState   *state_p);
 139 static inline Emission*         emission_find           (Emission        *emission_list,
 140                                                          guint            signal_id,
 141                                                          GQuark           detail,
 142                                                          gpointer         instance);
 143 static gint                     signal_key_cmp          (gconstpointer    node1,
 144                                                          gconstpointer    node2);
 145 static        gboolean          signal_emit_R           (SignalNode      *node,
 146                                                          GQuark           detail,
 147                                                          gpointer         instance,
 148                                                          GValue          *return_value,
 149                                                          const GValue    *instance_and_params);
 150
 151
 152 /* --- structures --- */
 153 typedef struct
 154 {
 155   GSignalAccumulator func;
 156   gpointer           data;
 157 } SignalAccumulator;
 158 typedef struct
 159 {
 160   GHook hook;
 161   GQuark detail;
 162 } SignalHook;
 163 #define SIGNAL_HOOK(hook)       ((SignalHook*) (hook))
 164
 165 struct _SignalNode
 166 {
 167   /* permanent portion */
 168   guint              signal_id;
 169   GType              itype;
 170   gchar             *name;
 171   guint              destroyed : 1;
 172
 173   /* reinitializable portion */
 174   guint              flags : 8;
 175   guint              n_params : 8;
 176   GType             *param_types; /* mangled with G_SIGNAL_TYPE_STATIC_SCOPE flag */
 177   GType              return_type; /* mangled with G_SIGNAL_TYPE_STATIC_SCOPE flag */
 178   GClosure          *class_closure;
 179   SignalAccumulator *accumulator;
 180   GSignalCMarshaller c_marshaller;
 181   GHookList         *emission_hooks;
 182 };
 183
 184 struct _SignalKey
 185 {
 186   GType  itype;
 187   GQuark quark;
 188   guint  signal_id;
 189 };
 190
 191 struct _Emission
 192 {
 193   Emission      *next;
 194   guint          signal_id;
 195   GQuark         detail;
 196   gpointer       instance;
 197   EmissionState *state_p;
 198 };
 199
 200 struct _HandlerList
 201 {
 202   guint    signal_id;
 203   Handler *handlers;
 204 };
 205 struct _Handler
 206 {
 207   gulong        sequential_number;
 208   Handler      *next;
 209   Handler      *prev;
 210   GQuark        detail;
 211   guint         ref_count : 16;
 212 #define HANDLER_MAX_REF_COUNT   (1 << 16)
 213   guint         block_count : 12;
 214 #define HANDLER_MAX_BLOCK_COUNT (1 << 12)
 215   guint         after : 1;
 216   GClosure     *closure;
 217 };
 218 struct _HandlerMatch
 219 {
 220   Handler      *handler;
 221   HandlerMatch *next;
 222   union {
 223     guint       signal_id;
 224     gpointer    dummy;
 225   } d;
 226 };
 227
 228
 229 /* --- variables --- */
 230 static GBSearchArray  g_signal_key_bsa = G_STATIC_BSEARCH_ARRAY_INIT (sizeof (SignalKey),
 231                                                                       signal_key_cmp,
 232                                                                       G_BSEARCH_ARRAY_ALIGN_POWER2);
 233 static GHashTable    *g_handler_list_bsa_ht = NULL;
 234 static Emission      *g_recursive_emissions = NULL;
 235 static Emission      *g_restart_emissions = NULL;
 236 static GTrashStack   *g_handler_ts = NULL;
 237 static GTrashStack   *g_emission_ts = NULL;
 238 static gulong         g_handler_sequential_number = 1;
 239 G_LOCK_DEFINE_STATIC (g_signal_mutex);
 240
 241
 242 /* --- signal nodes --- */
 243 static guint          g_n_signal_nodes = 0;
 244 static SignalNode   **g_signal_nodes = NULL;
 245
 246 static inline SignalNode*
 247 LOOKUP_SIGNAL_NODE (register guint signal_id)
 248 {
 249   if (signal_id < g_n_signal_nodes)
 250     return g_signal_nodes[signal_id];
 251   else
 252     return NULL;
 253 }
 254
 255
 256 /* --- functions --- */
 257 static inline guint
 258 signal_id_lookup (GQuark quark,
 259                   GType  itype)
 260 {
 261   GType *ifaces, type = itype;
 262   SignalKey key;
 263   guint n_ifaces;
 264
 265   key.quark = quark;
 266
 267   /* try looking up signals for this type and its anchestors */
 268   do
 269     {
 270       SignalKey *signal_key;
 271
 272       key.itype = type;
 273       signal_key = g_bsearch_array_lookup (&g_signal_key_bsa, &key);
 274
 275       if (signal_key)
 276         return signal_key->signal_id;
 277
 278       type = g_type_parent (type);
 279     }
 280   while (type);
 281
 282   /* no luck, try interfaces it exports */
 283   ifaces = g_type_interfaces (itype, &n_ifaces);
 284   while (n_ifaces--)
 285     {
 286       SignalKey *signal_key;
 287
 288       key.itype = ifaces[n_ifaces];
 289       signal_key = g_bsearch_array_lookup (&g_signal_key_bsa, &key);
 290
 291       if (signal_key)
 292         {
 293           g_free (ifaces);
 294           return signal_key->signal_id;
 295         }
 296     }
 297   g_free (ifaces);
 298
 299   return 0;
 300 }
 301
 302 static gint
 303 handler_lists_cmp (gconstpointer node1,
 304                    gconstpointer node2)
 305 {
 306   const HandlerList *hlist1 = node1, *hlist2 = node2;
 307
 308   return G_BSEARCH_ARRAY_CMP (hlist1->signal_id, hlist2->signal_id);
 309 }
 310
 311 static inline HandlerList*
 312 handler_list_ensure (guint    signal_id,
 313                      gpointer instance)
 314 {
 315   GBSearchArray *hlbsa = g_hash_table_lookup (g_handler_list_bsa_ht, instance);
 316   HandlerList key;
 317
 318   if (!hlbsa)
 319     {
 320       hlbsa = g_bsearch_array_new (sizeof (HandlerList), handler_lists_cmp, G_BSEARCH_ARRAY_DEFER_SHRINK);
 321       g_hash_table_insert (g_handler_list_bsa_ht, instance, hlbsa);
 322     }
 323   key.signal_id = signal_id;
 324   key.handlers = NULL;
 325
 326   return g_bsearch_array_insert (hlbsa, &key, FALSE);
 327 }
 328
 329 static inline HandlerList*
 330 handler_list_lookup (guint    signal_id,
 331                      gpointer instance)
 332 {
 333   GBSearchArray *hlbsa = g_hash_table_lookup (g_handler_list_bsa_ht, instance);
 334   HandlerList key;
 335
 336   key.signal_id = signal_id;
 337
 338   return hlbsa ? g_bsearch_array_lookup (hlbsa, &key) : NULL;
 339 }
 340
 341 static Handler*
 342 handler_lookup (gpointer instance,
 343                 gulong   handler_id,
 344                 guint   *signal_id_p)
 345 {
 346   GBSearchArray *hlbsa = g_hash_table_lookup (g_handler_list_bsa_ht, instance);
 347
 348   if (hlbsa)
 349     {
 350       guint i;
 351
 352       for (i = 0; i < hlbsa->n_nodes; i++)
 353         {
 354           HandlerList *hlist = g_bsearch_array_get_nth (hlbsa, i);
 355           Handler *handler;
 356
 357           for (handler = hlist->handlers; handler; handler = handler->next)
 358             if (handler->sequential_number == handler_id)
 359               {
 360                 if (signal_id_p)
 361                   *signal_id_p = hlist->signal_id;
 362
 363                 return handler;
 364               }
 365         }
 366     }
 367
 368   return NULL;
 369 }
 370
 371 static inline HandlerMatch*
 372 handler_match_prepend (HandlerMatch *list,
 373                        Handler      *handler,
 374                        guint         signal_id)
 375 {
 376   HandlerMatch *node;
 377
 378   /* yeah, we could use our own memchunk here, introducing yet more
 379    * rarely used cached nodes and extra allocation overhead.
 380    * instead, we use GList* nodes, since they are exactly the size
 381    * we need and are already cached. g_signal_init() asserts this.
 382    */
 383   node = (HandlerMatch*) g_list_alloc ();
 384   node->handler = handler;
 385   node->next = list;
 386   node->d.signal_id = signal_id;
 387   handler_ref (handler);
 388
 389   return node;
 390 }
 391 static inline HandlerMatch*
 392 handler_match_free1_R (HandlerMatch *node,
 393                        gpointer      instance)
 394 {
 395   HandlerMatch *next = node->next;
 396
 397   handler_unref_R (node->d.signal_id, instance, node->handler);
 398   g_list_free_1 ((GList*) node);
 399
 400   return next;
 401 }
 402
 403 static HandlerMatch*
 404 handlers_find (gpointer         instance,
 405                GSignalMatchType mask,
 406                guint            signal_id,
 407                GQuark           detail,
 408                GClosure        *closure,
 409                gpointer         func,
 410                gpointer         data,
 411                gboolean         one_and_only)
 412 {
 413   HandlerMatch *mlist = NULL;
 414
 415   if (mask & G_SIGNAL_MATCH_ID)
 416     {
 417       HandlerList *hlist = handler_list_lookup (signal_id, instance);
 418       Handler *handler;
 419       SignalNode *node = NULL;
 420
 421       if (mask & G_SIGNAL_MATCH_FUNC)
 422         {
 423           node = LOOKUP_SIGNAL_NODE (signal_id);
 424           if (!node || !node->c_marshaller)
 425             return NULL;
 426         }
 427
 428       mask = ~mask;
 429       for (handler = hlist ? hlist->handlers : NULL; handler; handler = handler->next)
 430         if (handler->sequential_number &&
 431             ((mask & G_SIGNAL_MATCH_DETAIL) || handler->detail == detail) &&
 432             ((mask & G_SIGNAL_MATCH_CLOSURE) || handler->closure == closure) &&
 433             ((mask & G_SIGNAL_MATCH_DATA) || handler->closure->data == data) &&
 434             ((mask & G_SIGNAL_MATCH_UNBLOCKED) || handler->block_count == 0) &&
 435             ((mask & G_SIGNAL_MATCH_FUNC) || (handler->closure->marshal == node->c_marshaller &&
 436                                               handler->closure->meta_marshal == 0 &&
 437                                               ((GCClosure*) handler->closure)->callback == func)))
 438           {
 439             mlist = handler_match_prepend (mlist, handler, signal_id);
 440             if (one_and_only)
 441               return mlist;
 442           }
 443     }
 444   else
 445     {
 446       GBSearchArray *hlbsa = g_hash_table_lookup (g_handler_list_bsa_ht, instance);
 447
 448       mask = ~mask;
 449       if (hlbsa)
 450         {
 451           guint i;
 452
 453           for (i = 0; i < hlbsa->n_nodes; i++)
 454             {
 455               HandlerList *hlist = g_bsearch_array_get_nth (hlbsa, i);
 456               SignalNode *node = NULL;
 457               Handler *handler;
 458
 459               if (!(mask & G_SIGNAL_MATCH_FUNC))
 460                 {
 461                   node = LOOKUP_SIGNAL_NODE (hlist->signal_id);
 462                   if (!node->c_marshaller)
 463                     continue;
 464                 }
 465
 466               for (handler = hlist->handlers; handler; handler = handler->next)
 467                 if (handler->sequential_number &&
 468                     ((mask & G_SIGNAL_MATCH_DETAIL) || handler->detail == detail) &&
 469                     ((mask & G_SIGNAL_MATCH_CLOSURE) || handler->closure == closure) &&
 470                     ((mask & G_SIGNAL_MATCH_DATA) || handler->closure->data == data) &&
 471                     ((mask & G_SIGNAL_MATCH_UNBLOCKED) || handler->block_count == 0) &&
 472                     ((mask & G_SIGNAL_MATCH_FUNC) || (handler->closure->marshal == node->c_marshaller &&
 473                                                       handler->closure->meta_marshal == 0 &&
 474                                                       ((GCClosure*) handler->closure)->callback == func)))
 475                   {
 476                     mlist = handler_match_prepend (mlist, handler, hlist->signal_id);
 477                     if (one_and_only)
 478                       return mlist;
 479                   }
 480             }
 481         }
 482     }
 483
 484   return mlist;
 485 }
 486
 487 static inline Handler*
 488 handler_new (gboolean after)
 489 {
 490   Handler *handler = g_generic_node_alloc (&g_handler_ts,
 491                                            sizeof (Handler),
 492                                            HANDLER_PRE_ALLOC);
 493 #ifndef G_DISABLE_CHECKS
 494   if (g_handler_sequential_number < 1)
 495     g_error (G_STRLOC ": handler id overflow, %s", REPORT_BUG);
 496 #endif
 497
 498   handler->sequential_number = g_handler_sequential_number++;
 499   handler->prev = NULL;
 500   handler->next = NULL;
 501   handler->detail = 0;
 502   handler->ref_count = 1;
 503   handler->block_count = 0;
 504   handler->after = after != FALSE;
 505   handler->closure = NULL;
 506
 507   return handler;
 508 }
 509
 510 static inline void
 511 handler_ref (Handler *handler)
 512 {
 513   g_return_if_fail (handler->ref_count > 0);
 514
 515 #ifndef G_DISABLE_CHECKS
 516   if (handler->ref_count >= HANDLER_MAX_REF_COUNT - 1)
 517     g_error (G_STRLOC ": handler ref_count overflow, %s", REPORT_BUG);
 518 #endif
 519
 520   handler->ref_count += 1;
 521 }
 522
 523 static inline void
 524 handler_unref_R (guint    signal_id,
 525                  gpointer instance,
 526                  Handler *handler)
 527 {
 528   g_return_if_fail (handler->ref_count > 0);
 529
 530   handler->ref_count -= 1;
 531   if (!handler->ref_count)
 532     {
 533       if (handler->next)
 534         handler->next->prev = handler->prev;
 535       if (handler->prev)        /* watch out for g_signal_handlers_destroy()! */
 536         handler->prev->next = handler->next;
 537       else
 538         {
 539           HandlerList *hlist = handler_list_lookup (signal_id, instance);
 540
 541           hlist->handlers = handler->next;
 542         }
 543       G_UNLOCK (g_signal_mutex);
 544       g_closure_unref (handler->closure);
 545       G_LOCK (g_signal_mutex);
 546       g_generic_node_free (&g_handler_ts, handler);
 547     }
 548 }
 549
 550 static void
 551 handler_insert (guint    signal_id,
 552                 gpointer instance,
 553                 Handler  *handler)
 554 {
 555   HandlerList *hlist;
 556
 557   g_assert (handler->prev == NULL && handler->next == NULL); /* paranoid */
 558
 559   hlist = handler_list_ensure (signal_id, instance);
 560   if (!hlist->handlers)
 561     hlist->handlers = handler;
 562   else if (hlist->handlers->after && !handler->after)
 563     {
 564       handler->next = hlist->handlers;
 565       hlist->handlers->prev = handler;
 566       hlist->handlers = handler;
 567     }
 568   else
 569     {
 570       Handler *tmp = hlist->handlers;
 571
 572       if (handler->after)
 573         while (tmp->next)
 574           tmp = tmp->next;
 575       else
 576         while (tmp->next && !tmp->next->after)
 577           tmp = tmp->next;
 578       if (tmp->next)
 579         tmp->next->prev = handler;
 580       handler->next = tmp->next;
 581       handler->prev = tmp;
 582       tmp->next = handler;
 583     }
 584 }
 585
 586 static inline void
 587 emission_push (Emission     **emission_list_p,
 588                guint          signal_id,
 589                GQuark         detail,
 590                gpointer       instance,
 591                EmissionState *state_p)
 592 {
 593   Emission *emission = g_generic_node_alloc (&g_emission_ts,
 594                                              sizeof (Emission),
 595                                              EMISSION_PRE_ALLOC);
 596   emission->next = *emission_list_p;
 597   emission->signal_id = signal_id;
 598   emission->detail = detail;
 599   emission->instance = instance;
 600   emission->state_p = state_p;
 601   *emission_list_p = emission;
 602 }
 603
 604 static inline void
 605 emission_pop (Emission     **emission_list_p,
 606               EmissionState *state_p)
 607 {
 608   Emission **loc = emission_list_p, *emission = *loc;
 609
 610   while (emission->state_p != state_p)
 611     {
 612       loc = &emission->next;
 613       emission = *loc;
 614     }
 615   *loc = emission->next;
 616   g_generic_node_free (&g_emission_ts, emission);
 617 }
 618
 619 static inline Emission*
 620 emission_find (Emission *emission_list,
 621                guint     signal_id,
 622                GQuark    detail,
 623                gpointer  instance)
 624 {
 625   Emission *emission;
 626
 627   for (emission = emission_list; emission; emission = emission->next)
 628     if (emission->instance == instance &&
 629         emission->signal_id == signal_id &&
 630         emission->detail == detail)
 631       return emission;
 632   return NULL;
 633 }
 634
 635 static gint
 636 signal_key_cmp (gconstpointer node1,
 637                 gconstpointer node2)
 638 {
 639   const SignalKey *key1 = node1, *key2 = node2;
 640
 641   if (key1->itype == key2->itype)
 642     return G_BSEARCH_ARRAY_CMP (key1->quark, key2->quark);
 643   else
 644     return G_BSEARCH_ARRAY_CMP (key1->itype, key2->itype);
 645 }
 646
 647 void
 648 g_signal_init (void) /* sync with gtype.c */
 649 {
 650   G_LOCK (g_signal_mutex);
 651   if (!g_n_signal_nodes)
 652     {
 653       /* handler_id_node_prepend() requires this */
 654       g_assert (sizeof (GList) == sizeof (HandlerMatch));
 655
 656       /* setup handler list binary searchable array hash table (in german, that'd be one word ;) */
 657       g_handler_list_bsa_ht = g_hash_table_new (g_direct_hash, NULL);
 658
 659       /* invalid (0) signal_id */
 660       g_n_signal_nodes = 1;
 661       g_signal_nodes = g_renew (SignalNode*, g_signal_nodes, g_n_signal_nodes);
 662       g_signal_nodes[0] = NULL;
 663     }
 664   G_UNLOCK (g_signal_mutex);
 665 }
 666
 667 void
 668 _g_signals_destroy (GType itype)
 669 {
 670   guint i;
 671
 672   G_LOCK (g_signal_mutex);
 673   for (i = 1; i < g_n_signal_nodes; i++)
 674     {
 675       SignalNode *node = g_signal_nodes[i];
 676
 677       if (node->itype == itype)
 678         {
 679           if (node->destroyed)
 680             g_warning (G_STRLOC ": signal \"%s\" of type `%s' already destroyed",
 681                        node->name,
 682                        g_type_name (node->itype));
 683           else
 684             signal_destroy_R (node);
 685         }
 686     }
 687   G_UNLOCK (g_signal_mutex);
 688 }
 689
 690 void
 691 g_signal_stop_emission (gpointer instance,
 692                         guint    signal_id,
 693                         GQuark   detail)
 694 {
 695   SignalNode *node;
 696
 697   g_return_if_fail (G_TYPE_CHECK_INSTANCE (instance));
 698   g_return_if_fail (signal_id > 0);
 699
 700   G_LOCK (g_signal_mutex);
 701   node = LOOKUP_SIGNAL_NODE (signal_id);
 702   if (node && detail && !(node->flags & G_SIGNAL_DETAILED))
 703     {
 704       g_warning ("%s: signal id `%u' does not support detail (%u)", G_STRLOC, signal_id, detail);
 705       G_UNLOCK (g_signal_mutex);
 706       return;
 707     }
 708   if (node && g_type_is_a (G_TYPE_FROM_INSTANCE (instance), node->itype))
 709     {
 710       Emission *emission_list = node->flags & G_SIGNAL_NO_RECURSE ? g_restart_emissions : g_recursive_emissions;
 711       Emission *emission = emission_find (emission_list, signal_id, detail, instance);
 712
 713       if (emission)
 714         {
 715           if (*emission->state_p == EMISSION_HOOK)
 716             g_warning (G_STRLOC ": emission of signal \"%s\" for instance `%p' cannot be stopped from emission hook",
 717                        node->name, instance);
 718           else if (*emission->state_p == EMISSION_RUN)
 719             *emission->state_p = EMISSION_STOP;
 720         }
 721       else
 722         g_warning (G_STRLOC ": no emission of signal \"%s\" to stop for instance `%p'",
 723                    node->name, instance);
 724     }
 725   else
 726     g_warning ("%s: signal id `%u' is invalid for instance `%p'", G_STRLOC, signal_id, instance);
 727   G_UNLOCK (g_signal_mutex);
 728 }
 729
 730 static void
 731 signal_finalize_hook (GHookList *hook_list,
 732                       GHook     *hook)
 733 {
 734   GDestroyNotify destroy = hook->destroy;
 735
 736   if (destroy)
 737     {
 738       hook->destroy = NULL;
 739       G_UNLOCK (g_signal_mutex);
 740       destroy (hook->data);
 741       G_LOCK (g_signal_mutex);
 742     }
 743 }
 744
 745 gulong
 746 g_signal_add_emission_hook (guint               signal_id,
 747                             GQuark              detail,
 748                             GSignalEmissionHook hook_func,
 749                             gpointer            hook_data,
 750                             GDestroyNotify      data_destroy)
 751 {
 752   static gulong seq_hook_id = 1;
 753   SignalNode *node;
 754   GHook *hook;
 755   SignalHook *signal_hook;
 756
 757   g_return_val_if_fail (signal_id > 0, 0);
 758   g_return_val_if_fail (hook_func != NULL, 0);
 759
 760   G_LOCK (g_signal_mutex);
 761   node = LOOKUP_SIGNAL_NODE (signal_id);
 762   if (!node || node->destroyed || (node->flags & G_SIGNAL_NO_HOOKS))
 763     {
 764       g_warning ("%s: invalid signal id `%u'", G_STRLOC, signal_id);
 765       G_UNLOCK (g_signal_mutex);
 766       return 0;
 767     }
 768   if (detail && !(node->flags & G_SIGNAL_DETAILED))
 769     {
 770       g_warning ("%s: signal id `%u' does not support detail (%u)", G_STRLOC, signal_id, detail);
 771       G_UNLOCK (g_signal_mutex);
 772       return 0;
 773     }
 774   if (!node->emission_hooks)
 775     {
 776       node->emission_hooks = g_new (GHookList, 1);
 777       g_hook_list_init (node->emission_hooks, sizeof (SignalHook));
 778       node->emission_hooks->finalize_hook = signal_finalize_hook;
 779     }
 780   hook = g_hook_alloc (node->emission_hooks);
 781   hook->data = hook_data;
 782   hook->func = hook_func;
 783   hook->destroy = data_destroy;
 784   signal_hook = SIGNAL_HOOK (hook);
 785   signal_hook->detail = detail;
 786   node->emission_hooks->seq_id = seq_hook_id;
 787   g_hook_append (node->emission_hooks, hook);
 788   seq_hook_id = node->emission_hooks->seq_id;
 789   G_UNLOCK (g_signal_mutex);
 790
 791   return hook->hook_id;
 792 }
 793
 794 void
 795 g_signal_remove_emission_hook (guint  signal_id,
 796                                gulong hook_id)
 797 {
 798   SignalNode *node;
 799
 800   g_return_if_fail (signal_id > 0);
 801   g_return_if_fail (hook_id > 0);
 802
 803   G_LOCK (g_signal_mutex);
 804   node = LOOKUP_SIGNAL_NODE (signal_id);
 805   if (!node || node->destroyed)
 806     g_warning ("%s: invalid signal id `%u'", G_STRLOC, signal_id);
 807   else if (!node->emission_hooks || !g_hook_destroy (node->emission_hooks, hook_id))
 808     g_warning ("%s: signal \"%s\" had no hook (%lu) to remove", G_STRLOC, node->name, hook_id);
 809   G_UNLOCK (g_signal_mutex);
 810 }
 811
 812 static inline guint
 813 signal_parse_name (const gchar *name,
 814                    GType        itype,
 815                    GQuark      *detail_p,
 816                    gboolean     force_quark)
 817 {
 818   const gchar *colon = strchr (name, ':');
 819   guint signal_id;
 820
 821   if (!colon)
 822     {
 823       signal_id = signal_id_lookup (g_quark_try_string (name), itype);
 824       if (signal_id && detail_p)
 825         *detail_p = 0;
 826     }
 827   else if (colon[1] == ':')
 828     {
 829       gchar buffer[32];
 830       guint l = colon - name;
 831
 832       if (l < 32)
 833         {
 834           memcpy (buffer, name, l);
 835           buffer[l] = 0;
 836           signal_id = signal_id_lookup (g_quark_try_string (buffer), itype);
 837         }
 838       else
 839         {
 840           gchar *signal = g_new (gchar, l + 1);
 841
 842           memcpy (signal, name, l);
 843           signal[l] = 0;
 844           signal_id = signal_id_lookup (g_quark_try_string (signal), itype);
 845           g_free (signal);
 846         }
 847
 848       if (signal_id && detail_p)
 849         *detail_p = colon[2] ? (force_quark ? g_quark_from_string : g_quark_try_string) (colon + 2) : 0;
 850     }
 851   else
 852     signal_id = 0;
 853   return signal_id;
 854 }
 855
 856 gboolean
 857 g_signal_parse_name (const gchar *detailed_signal,
 858                      GType        itype,
 859                      guint       *signal_id_p,
 860                      GQuark      *detail_p,
 861                      gboolean     force_detail_quark)
 862 {
 863   SignalNode *node;
 864   GQuark detail = 0;
 865   guint signal_id;
 866
 867   g_return_val_if_fail (detailed_signal != NULL, FALSE);
 868   g_return_val_if_fail (G_TYPE_IS_INSTANTIATABLE (itype) || G_TYPE_IS_INTERFACE (itype), FALSE);
 869
 870   G_LOCK (g_signal_mutex);
 871   signal_id = signal_parse_name (detailed_signal, itype, &detail, force_detail_quark);
 872   G_UNLOCK (g_signal_mutex);
 873
 874   node = signal_id ? LOOKUP_SIGNAL_NODE (signal_id) : NULL;
 875   if (!node || node->destroyed ||
 876       (detail && !(node->flags & G_SIGNAL_DETAILED)))
 877     return FALSE;
 878
 879   if (signal_id_p)
 880     *signal_id_p = signal_id;
 881   if (detail_p)
 882     *detail_p = detail;
 883
 884   return TRUE;
 885 }
 886
 887 guint
 888 g_signal_lookup (const gchar *name,
 889                  GType        itype)
 890 {
 891   guint signal_id;
 892
 893   g_return_val_if_fail (name != NULL, 0);
 894   g_return_val_if_fail (G_TYPE_IS_INSTANTIATABLE (itype) || G_TYPE_IS_INTERFACE (itype), 0);
 895
 896   G_LOCK (g_signal_mutex);
 897   signal_id = signal_id_lookup (g_quark_try_string (name), itype);
 898   G_UNLOCK (g_signal_mutex);
 899
 900   return signal_id;
 901 }
 902
 903 G_CONST_RETURN gchar*
 904 g_signal_name (guint signal_id)
 905 {
 906   SignalNode *node;
 907   gchar *name;
 908
 909   G_LOCK (g_signal_mutex);
 910   node = LOOKUP_SIGNAL_NODE (signal_id);
 911   name = node ? node->name : NULL;
 912   G_UNLOCK (g_signal_mutex);
 913
 914   return name;
 915 }
 916
 917 void
 918 g_signal_query (guint         signal_id,
 919                 GSignalQuery *query)
 920 {
 921   SignalNode *node;
 922
 923   g_return_if_fail (query != NULL);
 924
 925   G_LOCK (g_signal_mutex);
 926   node = LOOKUP_SIGNAL_NODE (signal_id);
 927   if (!node || node->destroyed)
 928     query->signal_id = 0;
 929   else
 930     {
 931       query->signal_id = node->signal_id;
 932       query->signal_name = node->name;
 933       query->itype = node->itype;
 934       query->signal_flags = node->flags;
 935       query->return_type = node->return_type;
 936       query->n_params = node->n_params;
 937       query->param_types = node->param_types;
 938     }
 939   G_UNLOCK (g_signal_mutex);
 940 }
 941
 942 guint*
 943 g_signal_list_ids (GType  itype,
 944                    guint *n_ids)
 945 {
 946   SignalKey *keys;
 947   GArray *result;
 948   guint n_nodes;
 949   guint i;
 950
 951   g_return_val_if_fail (G_TYPE_IS_INSTANTIATABLE (itype) || G_TYPE_IS_INTERFACE (itype), NULL);
 952   g_return_val_if_fail (n_ids != NULL, NULL);
 953
 954   G_LOCK (g_signal_mutex);
 955
 956   keys = g_signal_key_bsa.nodes;
 957   n_nodes  = g_signal_key_bsa.n_nodes;
 958   result = g_array_new (FALSE, FALSE, sizeof (guint));
 959
 960   for (i = 0; i < n_nodes; i++)
 961     if (keys[i].itype == itype)
 962       {
 963         const gchar *name = g_quark_to_string (keys[i].quark);
 964
 965         /* Signal names with "_" in them are aliases to the same
 966          * name with "-" instead of "_".
 967          */
 968         if (!strchr (name, '_'))
 969           g_array_append_val (result, keys[i].signal_id);
 970       }
 971
 972   *n_ids = result->len;
 973
 974   G_UNLOCK (g_signal_mutex);
 975
 976   return (guint*) g_array_free (result, FALSE);
 977 }
 978
 979 guint
 980 g_signal_new_valist (const gchar       *signal_name,
 981                      GType              itype,
 982                      GSignalFlags       signal_flags,
 983                      GClosure          *class_closure,
 984                      GSignalAccumulator accumulator,
 985                      gpointer           accu_data,
 986                      GSignalCMarshaller c_marshaller,
 987                      GType              return_type,
 988                      guint              n_params,
 989                      va_list            args)
 990 {
 991   GType *param_types;
 992   guint i;
 993   guint signal_id;
 994
 995   if (n_params > 0)
 996     {
 997       param_types = g_new (GType, n_params);
 998
 999       for (i = 0; i < n_params; i++)
1000         param_types[i] = va_arg (args, GType);
1001     }
1002   else
1003     param_types = NULL;
1004
1005   signal_id = g_signal_newv (signal_name, itype, signal_flags,
1006                              class_closure, accumulator, accu_data, c_marshaller,
1007                              return_type, n_params, param_types);
1008   g_free (param_types);
1009
1010   return signal_id;
1011 }
1012
1013 guint
1014 g_signal_newc (const gchar       *signal_name,
1015                GType              itype,
1016                GSignalFlags       signal_flags,
1017                guint              class_offset,
1018                GSignalAccumulator accumulator,
1019                gpointer           accu_data,
1020                GSignalCMarshaller c_marshaller,
1021                GType              return_type,
1022                guint              n_params,
1023                ...)
1024 {
1025   va_list args;
1026   guint signal_id;
1027
1028   g_return_val_if_fail (signal_name != NULL, 0);
1029
1030   va_start (args, n_params);
1031
1032   signal_id = g_signal_new_valist (signal_name, itype, signal_flags,
1033                                    class_offset ? g_signal_type_cclosure_new (itype, class_offset) : NULL,
1034                                    accumulator, accu_data, c_marshaller,
1035                                    return_type, n_params, args);
1036
1037   va_end (args);
1038
1039   return signal_id;
1040 }
1041
1042 guint
1043 g_signal_newv (const gchar       *signal_name,
1044                GType              itype,
1045                GSignalFlags       signal_flags,
1046                GClosure          *class_closure,
1047                GSignalAccumulator accumulator,
1048                gpointer           accu_data,
1049                GSignalCMarshaller c_marshaller,
1050                GType              return_type,
1051                guint              n_params,
1052                GType             *param_types)
1053 {
1054   gchar *name;
1055   guint signal_id, i;
1056   SignalNode *node;
1057
1058   g_return_val_if_fail (signal_name != NULL, 0);
1059   g_return_val_if_fail (G_TYPE_IS_INSTANTIATABLE (itype) || G_TYPE_IS_INTERFACE (itype), 0);
1060   if (n_params)
1061     g_return_val_if_fail (param_types != NULL, 0);
1062   g_return_val_if_fail ((return_type & G_SIGNAL_TYPE_STATIC_SCOPE) == 0, 0);
1063   if (return_type == (G_TYPE_NONE & ~G_SIGNAL_TYPE_STATIC_SCOPE))
1064     g_return_val_if_fail (accumulator == NULL, 0);
1065   if (!accumulator)
1066     g_return_val_if_fail (accu_data == NULL, 0);
1067
1068   name = g_strdup (signal_name);
1069   g_strdelimit (name, G_STR_DELIMITERS ":^", '_');  /* FIXME do character checks like for types */
1070
1071   G_LOCK (g_signal_mutex);
1072
1073   signal_id = signal_id_lookup (g_quark_try_string (name), itype);
1074   node = LOOKUP_SIGNAL_NODE (signal_id);
1075   if (node && !node->destroyed)
1076     {
1077       g_warning (G_STRLOC ": signal \"%s\" already exists in the `%s' %s",
1078                  name,
1079                  g_type_name (node->itype),
1080                  G_TYPE_IS_INTERFACE (node->itype) ? "interface" : "class ancestry");
1081       g_free (name);
1082       G_UNLOCK (g_signal_mutex);
1083       return 0;
1084     }
1085   if (node && node->itype != itype)
1086     {
1087       g_warning (G_STRLOC ": signal \"%s\" for type `%s' was previously created for type `%s'",
1088                  name,
1089                  g_type_name (itype),
1090                  g_type_name (node->itype));
1091       g_free (name);
1092       G_UNLOCK (g_signal_mutex);
1093       return 0;
1094     }
1095   for (i = 0; i < n_params; i++)
1096     if (!G_TYPE_IS_VALUE (param_types[i] & ~G_SIGNAL_TYPE_STATIC_SCOPE))
1097       {
1098         g_warning (G_STRLOC ": parameter %d of type `%s' for signal \"%s::%s\" is not a value type",
1099                    i + 1, g_type_name (param_types[i] & ~G_SIGNAL_TYPE_STATIC_SCOPE), g_type_name (itype), name);
1100         g_free (name);
1101         G_UNLOCK (g_signal_mutex);
1102         return 0;
1103       }
1104   if (return_type != G_TYPE_NONE && !G_TYPE_IS_VALUE (return_type & ~G_SIGNAL_TYPE_STATIC_SCOPE))
1105     {
1106       g_warning (G_STRLOC ": return value of type `%s' for signal \"%s::%s\" is not a value type",
1107                  g_type_name (return_type & ~G_SIGNAL_TYPE_STATIC_SCOPE), g_type_name (itype), name);
1108       g_free (name);
1109       G_UNLOCK (g_signal_mutex);
1110       return 0;
1111     }
1112   if (return_type != G_TYPE_NONE &&
1113       (signal_flags & (G_SIGNAL_RUN_FIRST | G_SIGNAL_RUN_LAST | G_SIGNAL_RUN_CLEANUP)) == G_SIGNAL_RUN_FIRST)
1114     {
1115       g_warning (G_STRLOC ": signal \"%s::%s\" has return type `%s' and is only G_SIGNAL_RUN_FIRST",
1116                  g_type_name (itype), name,
1117                  g_type_name (return_type & ~G_SIGNAL_TYPE_STATIC_SCOPE));
1118       g_free (name);
1119       G_UNLOCK (g_signal_mutex);
1120       return 0;
1121     }
1122
1123   /* setup permanent portion of signal node */
1124   if (!node)
1125     {
1126       SignalKey key;
1127
1128       signal_id = g_n_signal_nodes++;
1129       node = g_new (SignalNode, 1);
1130       node->signal_id = signal_id;
1131       g_signal_nodes = g_renew (SignalNode*, g_signal_nodes, g_n_signal_nodes);
1132       g_signal_nodes[signal_id] = node;
1133       node->itype = itype;
1134       node->name = name;
1135       key.itype = itype;
1136       key.quark = g_quark_from_string (node->name);
1137       key.signal_id = signal_id;
1138       g_bsearch_array_insert (&g_signal_key_bsa, &key, FALSE);
1139       g_strdelimit (node->name, "_", '-');
1140       key.quark = g_quark_from_static_string (node->name);
1141       g_bsearch_array_insert (&g_signal_key_bsa, &key, FALSE);
1142     }
1143   node->destroyed = FALSE;
1144
1145   /* setup reinitializable portion */
1146   node->flags = signal_flags & G_SIGNAL_FLAGS_MASK;
1147   node->n_params = n_params;
1148   node->param_types = g_memdup (param_types, sizeof (GType) * n_params);
1149   node->return_type = return_type;
1150   node->class_closure = class_closure ? g_closure_ref (class_closure) : NULL;
1151   if (class_closure)
1152     g_closure_sink (class_closure);
1153   if (accumulator)
1154     {
1155       node->accumulator = g_new (SignalAccumulator, 1);
1156       node->accumulator->func = accumulator;
1157       node->accumulator->data = accu_data;
1158     }
1159   else
1160     node->accumulator = NULL;
1161   node->c_marshaller = c_marshaller;
1162   node->emission_hooks = NULL;
1163   if (node->c_marshaller && class_closure && G_CLOSURE_NEEDS_MARSHAL (class_closure))
1164     g_closure_set_marshal (class_closure, node->c_marshaller);
1165   G_UNLOCK (g_signal_mutex);
1166   return signal_id;
1167 }
1168
1169 static void
1170 signal_destroy_R (SignalNode *signal_node)
1171 {
1172   SignalNode node = *signal_node;
1173
1174   signal_node->destroyed = TRUE;
1175
1176   /* reentrancy caution, zero out real contents first */
1177   signal_node->n_params = 0;
1178   signal_node->param_types = NULL;
1179   signal_node->return_type = 0;
1180   signal_node->class_closure = NULL;
1181   signal_node->accumulator = NULL;
1182   signal_node->c_marshaller = NULL;
1183   signal_node->emission_hooks = NULL;
1184
1185 #ifdef  G_ENABLE_DEBUG
1186   /* check current emissions */
1187   {
1188     Emission *emission;
1189
1190     for (emission = (node.flags & G_SIGNAL_NO_RECURSE) ? g_restart_emissions : g_recursive_emissions;
1191          emission; emission = emission->next)
1192       if (emission->signal_id == node.signal_id)
1193         g_critical (G_STRLOC ": signal \"%s\" being destroyed is currently in emission (instance `%p')",
1194                     node.name, emission->instance);
1195   }
1196 #endif
1197
1198   /* free contents that need to
1199    */
1200   G_UNLOCK (g_signal_mutex);
1201   g_free (node.param_types);
1202   g_closure_unref (node.class_closure);
1203   g_free (node.accumulator);
1204   if (node.emission_hooks)
1205     {
1206       g_hook_list_clear (node.emission_hooks);
1207       g_free (node.emission_hooks);
1208     }
1209   G_LOCK (g_signal_mutex);
1210 }
1211
1212 gulong
1213 g_signal_connect_closure_by_id (gpointer  instance,
1214                                 guint     signal_id,
1215                                 GQuark    detail,
1216                                 GClosure *closure,
1217                                 gboolean  after)
1218 {
1219   SignalNode *node;
1220   gulong handler_seq_no = 0;
1221
1222   g_return_val_if_fail (G_TYPE_CHECK_INSTANCE (instance), 0);
1223   g_return_val_if_fail (signal_id > 0, 0);
1224   g_return_val_if_fail (closure != NULL, 0);
1225
1226   G_LOCK (g_signal_mutex);
1227   node = LOOKUP_SIGNAL_NODE (signal_id);
1228   if (node)
1229     {
1230       if (detail && !(node->flags & G_SIGNAL_DETAILED))
1231         g_warning ("%s: signal id `%u' does not support detail (%u)", G_STRLOC, signal_id, detail);
1232       else if (!g_type_is_a (G_TYPE_FROM_INSTANCE (instance), node->itype))
1233         g_warning ("%s: signal id `%u' is invalid for instance `%p'", G_STRLOC, signal_id, instance);
1234       else
1235         {
1236           Handler *handler = handler_new (after);
1237
1238           handler_seq_no = handler->sequential_number;
1239           handler->detail = detail;
1240           handler->closure = g_closure_ref (closure);
1241           g_closure_sink (closure);
1242           handler_insert (signal_id, instance, handler);
1243           if (node->c_marshaller && G_CLOSURE_NEEDS_MARSHAL (closure))
1244             g_closure_set_marshal (closure, node->c_marshaller);
1245         }
1246     }
1247   else
1248     g_warning ("%s: signal id `%u' is invalid for instance `%p'", G_STRLOC, signal_id, instance);
1249   G_UNLOCK (g_signal_mutex);
1250
1251   return handler_seq_no;
1252 }
1253
1254 gulong
1255 g_signal_connect_closure (gpointer     instance,
1256                           const gchar *detailed_signal,
1257                           GClosure    *closure,
1258                           gboolean     after)
1259 {
1260   guint signal_id;
1261   gulong handler_seq_no = 0;
1262   GQuark detail = 0;
1263   GType itype;
1264
1265   g_return_val_if_fail (G_TYPE_CHECK_INSTANCE (instance), 0);
1266   g_return_val_if_fail (detailed_signal != NULL, 0);
1267   g_return_val_if_fail (closure != NULL, 0);
1268
1269   G_LOCK (g_signal_mutex);
1270   itype = G_TYPE_FROM_INSTANCE (instance);
1271   signal_id = signal_parse_name (detailed_signal, itype, &detail, TRUE);
1272   if (signal_id)
1273     {
1274       SignalNode *node = LOOKUP_SIGNAL_NODE (signal_id);
1275
1276       if (detail && !(node->flags & G_SIGNAL_DETAILED))
1277         g_warning ("%s: signal `%s' does not support details", G_STRLOC, detailed_signal);
1278       else if (!g_type_is_a (itype, node->itype))
1279         g_warning ("%s: signal `%s' is invalid for instance `%p'", G_STRLOC, detailed_signal, instance);
1280       else
1281         {
1282           Handler *handler = handler_new (after);
1283
1284           handler_seq_no = handler->sequential_number;
1285           handler->detail = detail;
1286           handler->closure = g_closure_ref (closure);
1287           g_closure_sink (closure);
1288           handler_insert (signal_id, instance, handler);
1289           if (node->c_marshaller && G_CLOSURE_NEEDS_MARSHAL (handler->closure))
1290             g_closure_set_marshal (handler->closure, node->c_marshaller);
1291         }
1292     }
1293   else
1294     g_warning ("%s: signal `%s' is invalid for instance `%p'", G_STRLOC, detailed_signal, instance);
1295   G_UNLOCK (g_signal_mutex);
1296
1297   return handler_seq_no;
1298 }
1299
1300 gulong
1301 g_signal_connect_data (gpointer       instance,
1302                        const gchar   *detailed_signal,
1303                        GCallback      c_handler,
1304                        gpointer       data,
1305                        GClosureNotify destroy_data,
1306                        gboolean       swapped,
1307                        gboolean       after)
1308 {
1309   guint signal_id;
1310   gulong handler_seq_no = 0;
1311   GQuark detail = 0;
1312   GType itype;
1313
1314   g_return_val_if_fail (G_TYPE_CHECK_INSTANCE (instance), 0);
1315   g_return_val_if_fail (detailed_signal != NULL, 0);
1316   g_return_val_if_fail (c_handler != NULL, 0);
1317
1318   G_LOCK (g_signal_mutex);
1319   itype = G_TYPE_FROM_INSTANCE (instance);
1320   signal_id = signal_parse_name (detailed_signal, itype, &detail, TRUE);
1321   if (signal_id)
1322     {
1323       SignalNode *node = LOOKUP_SIGNAL_NODE (signal_id);
1324
1325       if (detail && !(node->flags & G_SIGNAL_DETAILED))
1326         g_warning ("%s: signal `%s' does not support details", G_STRLOC, detailed_signal);
1327       else if (!g_type_is_a (itype, node->itype))
1328         g_warning ("%s: signal `%s' is invalid for instance `%p'", G_STRLOC, detailed_signal, instance);
1329       else
1330         {
1331           Handler *handler = handler_new (after);
1332
1333           handler_seq_no = handler->sequential_number;
1334           handler->detail = detail;
1335           handler->closure = g_closure_ref ((swapped ? g_cclosure_new_swap : g_cclosure_new) (c_handler, data, destroy_data));
1336           g_closure_sink (handler->closure);
1337           handler_insert (signal_id, instance, handler);
1338           if (node->c_marshaller && G_CLOSURE_NEEDS_MARSHAL (handler->closure))
1339             g_closure_set_marshal (handler->closure, node->c_marshaller);
1340         }
1341     }
1342   else
1343     g_warning ("%s: signal `%s' is invalid for instance `%p'", G_STRLOC, detailed_signal, instance);
1344   G_UNLOCK (g_signal_mutex);
1345
1346   return handler_seq_no;
1347 }
1348
1349 void
1350 g_signal_handler_block (gpointer instance,
1351                         gulong   handler_id)
1352 {
1353   Handler *handler;
1354
1355   g_return_if_fail (G_TYPE_CHECK_INSTANCE (instance));
1356   g_return_if_fail (handler_id > 0);
1357
1358   G_LOCK (g_signal_mutex);
1359   handler = handler_lookup (instance, handler_id, NULL);
1360   if (handler)
1361     {
1362 #ifndef G_DISABLE_CHECKS
1363       if (handler->block_count >= HANDLER_MAX_BLOCK_COUNT - 1)
1364         g_error (G_STRLOC ": handler block_count overflow, %s", REPORT_BUG);
1365 #endif
1366       handler->block_count += 1;
1367     }
1368   else
1369     g_warning ("%s: instance `%p' has no handler with id `%lu'", G_STRLOC, instance, handler_id);
1370   G_UNLOCK (g_signal_mutex);
1371 }
1372
1373 void
1374 g_signal_handler_unblock (gpointer instance,
1375                           gulong   handler_id)
1376 {
1377   Handler *handler;
1378
1379   g_return_if_fail (G_TYPE_CHECK_INSTANCE (instance));
1380   g_return_if_fail (handler_id > 0);
1381
1382   G_LOCK (g_signal_mutex);
1383   handler = handler_lookup (instance, handler_id, NULL);
1384   if (handler)
1385     {
1386       if (handler->block_count)
1387         handler->block_count -= 1;
1388       else
1389         g_warning (G_STRLOC ": handler `%lu' of instance `%p' is not blocked", handler_id, instance);
1390     }
1391   else
1392     g_warning ("%s: instance `%p' has no handler with id `%lu'", G_STRLOC, instance, handler_id);
1393   G_UNLOCK (g_signal_mutex);
1394 }
1395
1396 void
1397 g_signal_handler_disconnect (gpointer instance,
1398                              gulong   handler_id)
1399 {
1400   Handler *handler;
1401   guint signal_id;
1402
1403   g_return_if_fail (G_TYPE_CHECK_INSTANCE (instance));
1404   g_return_if_fail (handler_id > 0);
1405
1406   G_LOCK (g_signal_mutex);
1407   handler = handler_lookup (instance, handler_id, &signal_id);
1408   if (handler)
1409     {
1410       handler->sequential_number = 0;
1411       handler->block_count = 1;
1412       handler_unref_R (signal_id, instance, handler);
1413     }
1414   else
1415     g_warning ("%s: instance `%p' has no handler with id `%lu'", G_STRLOC, instance, handler_id);
1416   G_UNLOCK (g_signal_mutex);
1417 }
1418
1419 gboolean
1420 g_signal_handler_is_connected (gpointer instance,
1421                                gulong   handler_id)
1422 {
1423   Handler *handler;
1424   gboolean connected;
1425
1426   g_return_val_if_fail (G_TYPE_CHECK_INSTANCE (instance), FALSE);
1427   g_return_val_if_fail (handler_id > 0, FALSE);
1428
1429   G_LOCK (g_signal_mutex);
1430   handler = handler_lookup (instance, handler_id, NULL);
1431   connected = handler != NULL;
1432   G_UNLOCK (g_signal_mutex);
1433
1434   return connected;
1435 }
1436
1437 void
1438 g_signal_handlers_destroy (gpointer instance)
1439 {
1440   GBSearchArray *hlbsa;
1441
1442   g_return_if_fail (G_TYPE_CHECK_INSTANCE (instance));
1443
1444   G_LOCK (g_signal_mutex);
1445   hlbsa = g_hash_table_lookup (g_handler_list_bsa_ht, instance);
1446   if (hlbsa)
1447     {
1448       guint i;
1449
1450       /* reentrancy caution, delete instance trace first */
1451       g_hash_table_remove (g_handler_list_bsa_ht, instance);
1452
1453       for (i = 0; i < hlbsa->n_nodes; i++)
1454         {
1455           HandlerList *hlist = g_bsearch_array_get_nth (hlbsa, i);
1456           Handler *handler = hlist->handlers;
1457
1458           while (handler)
1459             {
1460               Handler *tmp = handler;
1461
1462               handler = tmp->next;
1463               tmp->block_count = 1;
1464               /* cruel unlink, this works because _all_ handlers vanish */
1465               tmp->next = NULL;
1466               tmp->prev = tmp;
1467               if (tmp->sequential_number)
1468                 {
1469                   tmp->sequential_number = 0;
1470                   handler_unref_R (0, NULL, tmp);
1471                 }
1472             }
1473         }
1474       g_bsearch_array_destroy (hlbsa);
1475     }
1476   G_UNLOCK (g_signal_mutex);
1477 }
1478
1479 gulong
1480 g_signal_handler_find (gpointer         instance,
1481                        GSignalMatchType mask,
1482                        guint            signal_id,
1483                        GQuark           detail,
1484                        GClosure        *closure,
1485                        gpointer         func,
1486                        gpointer         data)
1487 {
1488   gulong handler_seq_no = 0;
1489
1490   g_return_val_if_fail (G_TYPE_CHECK_INSTANCE (instance), 0);
1491   g_return_val_if_fail ((mask & ~G_SIGNAL_MATCH_MASK) == 0, 0);
1492
1493   if (mask & G_SIGNAL_MATCH_MASK)
1494     {
1495       HandlerMatch *mlist;
1496
1497       G_LOCK (g_signal_mutex);
1498       mlist = handlers_find (instance, mask, signal_id, detail, closure, func, data, TRUE);
1499       if (mlist)
1500         {
1501           handler_seq_no = mlist->handler->sequential_number;
1502           handler_match_free1_R (mlist, instance);
1503         }
1504       G_UNLOCK (g_signal_mutex);
1505     }
1506
1507   return handler_seq_no;
1508 }
1509
1510 static guint
1511 signal_handlers_foreach_matched_R (gpointer         instance,
1512                                    GSignalMatchType mask,
1513                                    guint            signal_id,
1514                                    GQuark           detail,
1515                                    GClosure        *closure,
1516                                    gpointer         func,
1517                                    gpointer         data,
1518                                    void           (*callback) (gpointer instance,
1519                                                                gulong   handler_seq_no))
1520 {
1521   HandlerMatch *mlist;
1522   guint n_handlers = 0;
1523
1524   mlist = handlers_find (instance, mask, signal_id, detail, closure, func, data, FALSE);
1525   while (mlist)
1526     {
1527       n_handlers++;
1528       if (mlist->handler->sequential_number)
1529         {
1530           G_UNLOCK (g_signal_mutex);
1531           callback (instance, mlist->handler->sequential_number);
1532           G_LOCK (g_signal_mutex);
1533         }
1534       mlist = handler_match_free1_R (mlist, instance);
1535     }
1536
1537   return n_handlers;
1538 }
1539
1540 guint
1541 g_signal_handlers_block_matched (gpointer         instance,
1542                                  GSignalMatchType mask,
1543                                  guint            signal_id,
1544                                  GQuark           detail,
1545                                  GClosure        *closure,
1546                                  gpointer         func,
1547                                  gpointer         data)
1548 {
1549   guint n_handlers = 0;
1550
1551   g_return_val_if_fail (G_TYPE_CHECK_INSTANCE (instance), FALSE);
1552   g_return_val_if_fail ((mask & ~G_SIGNAL_MATCH_MASK) == 0, FALSE);
1553
1554   if (mask & (G_SIGNAL_MATCH_CLOSURE | G_SIGNAL_MATCH_FUNC | G_SIGNAL_MATCH_DATA))
1555     {
1556       G_LOCK (g_signal_mutex);
1557       n_handlers = signal_handlers_foreach_matched_R (instance, mask, signal_id, detail,
1558                                                       closure, func, data,
1559                                                       g_signal_handler_block);
1560       G_UNLOCK (g_signal_mutex);
1561     }
1562
1563   return n_handlers;
1564 }
1565
1566 guint
1567 g_signal_handlers_unblock_matched (gpointer         instance,
1568                                    GSignalMatchType mask,
1569                                    guint            signal_id,
1570                                    GQuark           detail,
1571                                    GClosure        *closure,
1572                                    gpointer         func,
1573                                    gpointer         data)
1574 {
1575   guint n_handlers = 0;
1576
1577   g_return_val_if_fail (G_TYPE_CHECK_INSTANCE (instance), FALSE);
1578   g_return_val_if_fail ((mask & ~G_SIGNAL_MATCH_MASK) == 0, FALSE);
1579
1580   if (mask & (G_SIGNAL_MATCH_CLOSURE | G_SIGNAL_MATCH_FUNC | G_SIGNAL_MATCH_DATA))
1581     {
1582       G_LOCK (g_signal_mutex);
1583       n_handlers = signal_handlers_foreach_matched_R (instance, mask, signal_id, detail,
1584                                                       closure, func, data,
1585                                                       g_signal_handler_unblock);
1586       G_UNLOCK (g_signal_mutex);
1587     }
1588
1589   return n_handlers;
1590 }
1591
1592 guint
1593 g_signal_handlers_disconnect_matched (gpointer         instance,
1594                                       GSignalMatchType mask,
1595                                       guint            signal_id,
1596                                       GQuark           detail,
1597                                       GClosure        *closure,
1598                                       gpointer         func,
1599                                       gpointer         data)
1600 {
1601   guint n_handlers = 0;
1602
1603   g_return_val_if_fail (G_TYPE_CHECK_INSTANCE (instance), FALSE);
1604   g_return_val_if_fail ((mask & ~G_SIGNAL_MATCH_MASK) == 0, FALSE);
1605
1606   if (mask & (G_SIGNAL_MATCH_CLOSURE | G_SIGNAL_MATCH_FUNC | G_SIGNAL_MATCH_DATA))
1607     {
1608       G_LOCK (g_signal_mutex);
1609       n_handlers = signal_handlers_foreach_matched_R (instance, mask, signal_id, detail,
1610                                                       closure, func, data,
1611                                                       g_signal_handler_disconnect);
1612       G_UNLOCK (g_signal_mutex);
1613     }
1614
1615   return n_handlers;
1616 }
1617
1618 gboolean
1619 g_signal_has_handler_pending (gpointer instance,
1620                               guint    signal_id,
1621                               GQuark   detail,
1622                               gboolean may_be_blocked)
1623 {
1624   HandlerMatch *mlist;
1625   gboolean has_pending;
1626
1627   g_return_val_if_fail (G_TYPE_CHECK_INSTANCE (instance), FALSE);
1628   g_return_val_if_fail (signal_id > 0, FALSE);
1629
1630   G_LOCK (g_signal_mutex);
1631   if (detail)
1632     {
1633       SignalNode *node = LOOKUP_SIGNAL_NODE (signal_id);
1634
1635       if (!(node->flags & G_SIGNAL_DETAILED))
1636         {
1637           g_warning ("%s: signal id `%u' does not support detail (%u)", G_STRLOC, signal_id, detail);
1638           G_UNLOCK (g_signal_mutex);
1639           return FALSE;
1640         }
1641     }
1642   mlist = handlers_find (instance,
1643                          (G_SIGNAL_MATCH_ID | G_SIGNAL_MATCH_DETAIL | (may_be_blocked ? 0 : G_SIGNAL_MATCH_UNBLOCKED)),
1644                          signal_id, detail, NULL, NULL, NULL, TRUE);
1645   if (mlist)
1646     {
1647       has_pending = TRUE;
1648       handler_match_free1_R (mlist, instance);
1649     }
1650   else
1651     has_pending = FALSE;
1652   G_UNLOCK (g_signal_mutex);
1653
1654   return has_pending;
1655 }
1656
1657 void
1658 g_signal_emitv (const GValue *instance_and_params,
1659                 guint         signal_id,
1660                 GQuark        detail,
1661                 GValue       *return_value)
1662 {
1663   const GValue *param_values;
1664   gpointer instance;
1665   SignalNode *node;
1666   guint i;
1667
1668   g_return_if_fail (instance_and_params != NULL);
1669   instance = g_value_peek_pointer (instance_and_params);
1670   g_return_if_fail (G_TYPE_CHECK_INSTANCE (instance));
1671   g_return_if_fail (signal_id > 0);
1672
1673   param_values = instance_and_params + 1;
1674
1675   G_LOCK (g_signal_mutex);
1676   node = LOOKUP_SIGNAL_NODE (signal_id);
1677   if (!node || !g_type_is_a (G_TYPE_FROM_INSTANCE (instance), node->itype))
1678     {
1679       g_warning ("%s: signal id `%u' is invalid for instance `%p'", G_STRLOC, signal_id, instance);
1680       G_UNLOCK (g_signal_mutex);
1681       return;
1682     }
1683 #ifdef G_ENABLE_DEBUG
1684   if (detail && !(node->flags & G_SIGNAL_DETAILED))
1685     {
1686       g_warning ("%s: signal id `%u' does not support detail (%u)", G_STRLOC, signal_id, detail);
1687       G_UNLOCK (g_signal_mutex);
1688       return;
1689     }
1690   for (i = 0; i < node->n_params; i++)
1691     if (!G_TYPE_CHECK_VALUE_TYPE (param_values + i, node->param_types[i] & ~G_SIGNAL_TYPE_STATIC_SCOPE))
1692       {
1693         g_critical ("%s: value for `%s' parameter %u for signal \"%s\" is of type `%s'",
1694                     G_STRLOC,
1695                     g_type_name (node->param_types[i] & ~G_SIGNAL_TYPE_STATIC_SCOPE),
1696                     i,
1697                     node->name,
1698                     G_VALUE_TYPE_NAME (param_values + i));
1699         G_UNLOCK (g_signal_mutex);
1700         return;
1701       }
1702   if (node->return_type != G_TYPE_NONE)
1703     {
1704       if (!return_value)
1705         {
1706           g_critical ("%s: return value `%s' for signal \"%s\" is (NULL)",
1707                       G_STRLOC,
1708                       g_type_name (node->return_type & ~G_SIGNAL_TYPE_STATIC_SCOPE),
1709                       node->name);
1710           G_UNLOCK (g_signal_mutex);
1711           return;
1712         }
1713       else if (!node->accumulator && !G_TYPE_CHECK_VALUE_TYPE (return_value, node->return_type & ~G_SIGNAL_TYPE_STATIC_SCOPE))
1714         {
1715           g_critical ("%s: return value `%s' for signal \"%s\" is of type `%s'",
1716                       G_STRLOC,
1717                       g_type_name (node->return_type & ~G_SIGNAL_TYPE_STATIC_SCOPE),
1718                       node->name,
1719                       G_VALUE_TYPE_NAME (return_value));
1720           G_UNLOCK (g_signal_mutex);
1721           return;
1722         }
1723     }
1724   else
1725     return_value = NULL;
1726 #endif  /* G_ENABLE_DEBUG */
1727
1728   signal_emit_R (node, detail, instance, return_value, instance_and_params);
1729   G_UNLOCK (g_signal_mutex);
1730 }
1731
1732 void
1733 g_signal_emit_valist (gpointer instance,
1734                       guint    signal_id,
1735                       GQuark   detail,
1736                       va_list  var_args)
1737 {
1738   GValue *instance_and_params, stack_values[MAX_STACK_VALUES], *free_me = NULL;
1739   GValue *param_values;
1740   SignalNode *node;
1741   guint i;
1742
1743   g_return_if_fail (G_TYPE_CHECK_INSTANCE (instance));
1744   g_return_if_fail (signal_id > 0);
1745
1746   G_LOCK (g_signal_mutex);
1747   node = LOOKUP_SIGNAL_NODE (signal_id);
1748   if (!node || !g_type_is_a (G_TYPE_FROM_INSTANCE (instance), node->itype))
1749     {
1750       g_warning ("%s: signal id `%u' is invalid for instance `%p'", G_STRLOC, signal_id, instance);
1751       G_UNLOCK (g_signal_mutex);
1752       return;
1753     }
1754 #ifndef G_DISABLE_CHECKS
1755   if (detail && !(node->flags & G_SIGNAL_DETAILED))
1756     {
1757       g_warning ("%s: signal id `%u' does not support detail (%u)", G_STRLOC, signal_id, detail);
1758       G_UNLOCK (g_signal_mutex);
1759       return;
1760     }
1761 #endif  /* !G_DISABLE_CHECKS */
1762
1763   if (node->n_params < MAX_STACK_VALUES)
1764     instance_and_params = stack_values;
1765   else
1766     {
1767       free_me = g_new (GValue, node->n_params + 1);
1768       instance_and_params = free_me;
1769     }
1770   param_values = instance_and_params + 1;
1771   for (i = 0; i < node->n_params; i++)
1772     {
1773       gchar *error;
1774
1775       param_values[i].g_type = 0;
1776       g_value_init (param_values + i, node->param_types[i] & ~G_SIGNAL_TYPE_STATIC_SCOPE);
1777       G_VALUE_COLLECT (param_values + i,
1778                        var_args,
1779                        node->param_types[i] & G_SIGNAL_TYPE_STATIC_SCOPE ? G_VALUE_NOCOPY_CONTENTS : 0,
1780                        &error);
1781       if (error)
1782         {
1783           g_warning ("%s: %s", G_STRLOC, error);
1784           g_free (error);
1785
1786           /* we purposely leak the value here, it might not be
1787            * in a sane state if an error condition occoured
1788            */
1789           while (i--)
1790             g_value_unset (param_values + i);
1791
1792           G_UNLOCK (g_signal_mutex);
1793           g_free (free_me);
1794           return;
1795         }
1796     }
1797   instance_and_params->g_type = 0;
1798   g_value_init (instance_and_params, G_TYPE_FROM_INSTANCE (instance));
1799   g_value_set_instance (instance_and_params, instance);
1800   if (node->return_type == G_TYPE_NONE)
1801     signal_emit_R (node, detail, instance, NULL, instance_and_params);
1802   else
1803     {
1804       GValue return_value = { 0, };
1805       gchar *error = NULL;
1806
1807       g_value_init (&return_value, node->return_type & ~G_SIGNAL_TYPE_STATIC_SCOPE);
1808       signal_emit_R (node, detail, instance, &return_value, instance_and_params);
1809       G_VALUE_LCOPY (&return_value,
1810                      var_args,
1811                      node->return_type & G_SIGNAL_TYPE_STATIC_SCOPE ? G_VALUE_NOCOPY_CONTENTS : 0,
1812                      &error);
1813       if (!error)
1814         g_value_unset (&return_value);
1815       else
1816         {
1817           g_warning ("%s: %s", G_STRLOC, error);
1818           g_free (error);
1819
1820           /* we purposely leak the value here, it might not be
1821            * in a sane state if an error condition occoured
1822            */
1823         }
1824     }
1825   for (i = 0; i < node->n_params; i++)
1826     g_value_unset (param_values + i);
1827   g_value_unset (instance_and_params);
1828   if (free_me)
1829     g_free (free_me);
1830   G_UNLOCK (g_signal_mutex);
1831 }
1832
1833 void
1834 g_signal_emit (gpointer instance,
1835                guint    signal_id,
1836                GQuark   detail,
1837                ...)
1838 {
1839   va_list var_args;
1840
1841   va_start (var_args, detail);
1842   g_signal_emit_valist (instance, signal_id, detail, var_args);
1843   va_end (var_args);
1844 }
1845
1846 void
1847 g_signal_emit_by_name (gpointer     instance,
1848                        const gchar *detailed_signal,
1849                        ...)
1850 {
1851   GQuark detail = 0;
1852   guint signal_id;
1853
1854   g_return_if_fail (G_TYPE_CHECK_INSTANCE (instance));
1855   g_return_if_fail (detailed_signal != NULL);
1856
1857   G_LOCK (g_signal_mutex);
1858   signal_id = signal_parse_name (detailed_signal, G_TYPE_FROM_INSTANCE (instance), &detail, TRUE);
1859   G_UNLOCK (g_signal_mutex);
1860
1861   if (signal_id)
1862     {
1863       va_list var_args;
1864
1865       va_start (var_args, detailed_signal);
1866       g_signal_emit_valist (instance, signal_id, detail, var_args);
1867       va_end (var_args);
1868     }
1869   else
1870     g_warning ("%s: signal name `%s' is invalid for instance `%p'", G_STRLOC, detailed_signal, instance);
1871 }
1872
1873 static inline gboolean
1874 accumulate (GSignalInvocationHint *ihint,
1875             GValue                *return_accu,
1876             GValue                *handler_return,
1877             SignalAccumulator     *accumulator)
1878 {
1879   gboolean continue_emission;
1880
1881   if (!accumulator)
1882     return TRUE;
1883
1884   continue_emission = accumulator->func (ihint, return_accu, handler_return, accumulator->data);
1885   g_value_reset (handler_return);
1886
1887   return continue_emission;
1888 }
1889
1890 static gboolean
1891 signal_emit_R (SignalNode   *node,
1892                GQuark        detail,
1893                gpointer      instance,
1894                GValue       *emission_return,
1895                const GValue *instance_and_params)
1896 {
1897   EmissionState emission_state = 0;
1898   SignalAccumulator *accumulator;
1899   GSignalInvocationHint ihint;
1900   GClosure *class_closure;
1901   HandlerList *hlist;
1902   Handler *handler_list = NULL;
1903   GValue *return_accu, accu = { 0, };
1904   guint signal_id = node->signal_id;
1905   gulong max_sequential_handler_number;
1906   gboolean return_value_altered = FALSE;
1907
1908 #ifdef  G_ENABLE_DEBUG
1909   IF_DEBUG (SIGNALS, g_trace_instance_signals == instance || g_trap_instance_signals == instance)
1910     {
1911       g_message ("%s::%s(%u) emitted (instance=%p, signal-node=%p)",
1912                  g_type_name (G_TYPE_FROM_INSTANCE (instance)),
1913                  node->name, detail,
1914                  instance, node);
1915       if (g_trap_instance_signals == instance)
1916         G_BREAKPOINT ();
1917     }
1918 #endif  /* G_ENABLE_DEBUG */
1919
1920   if (node->flags & G_SIGNAL_NO_RECURSE)
1921     {
1922       Emission *emission = emission_find (g_restart_emissions, signal_id, detail, instance);
1923
1924       if (emission)
1925         {
1926           *emission->state_p = EMISSION_RESTART;
1927           return return_value_altered;
1928         }
1929     }
1930   ihint.signal_id = node->signal_id;
1931   ihint.detail = detail;
1932   accumulator = node->accumulator;
1933   if (accumulator)
1934     {
1935       g_value_init (&accu, node->return_type & ~G_SIGNAL_TYPE_STATIC_SCOPE);
1936       return_accu = &accu;
1937     }
1938   else
1939     return_accu = emission_return;
1940   emission_push ((node->flags & G_SIGNAL_NO_RECURSE) ? &g_restart_emissions : &g_recursive_emissions,
1941                  signal_id, detail, instance, &emission_state);
1942   class_closure = node->class_closure;
1943
1944  EMIT_RESTART:
1945
1946   if (handler_list)
1947     handler_unref_R (signal_id, instance, handler_list);
1948   max_sequential_handler_number = g_handler_sequential_number;
1949   hlist = handler_list_lookup (signal_id, instance);
1950   handler_list = hlist ? hlist->handlers : NULL;
1951   if (handler_list)
1952     handler_ref (handler_list);
1953
1954   ihint.run_type = G_SIGNAL_RUN_FIRST;
1955
1956   if ((node->flags & G_SIGNAL_RUN_FIRST) && class_closure)
1957     {
1958       emission_state = EMISSION_RUN;
1959
1960       G_UNLOCK (g_signal_mutex);
1961       g_closure_invoke (class_closure,
1962                         return_accu,
1963                         node->n_params + 1,
1964                         instance_and_params,
1965                         &ihint);
1966       if (!accumulate (&ihint, emission_return, &accu, accumulator) &&
1967           emission_state == EMISSION_RUN)
1968         emission_state = EMISSION_STOP;
1969       G_LOCK (g_signal_mutex);
1970       return_value_altered = TRUE;
1971
1972       if (emission_state == EMISSION_STOP)
1973         goto EMIT_CLEANUP;
1974       else if (emission_state == EMISSION_RESTART)
1975         goto EMIT_RESTART;
1976     }
1977
1978   if (node->emission_hooks)
1979     {
1980       gboolean need_destroy, was_in_call, may_recurse = TRUE;
1981       GHook *hook;
1982
1983       emission_state = EMISSION_HOOK;
1984       hook = g_hook_first_valid (node->emission_hooks, may_recurse);
1985       while (hook)
1986         {
1987           SignalHook *signal_hook = SIGNAL_HOOK (hook);
1988
1989           if (!signal_hook->detail || signal_hook->detail == detail)
1990             {
1991               GSignalEmissionHook hook_func = hook->func;
1992
1993               was_in_call = G_HOOK_IN_CALL (hook);
1994               hook->flags |= G_HOOK_FLAG_IN_CALL;
1995               G_UNLOCK (g_signal_mutex);
1996               need_destroy = !hook_func (&ihint, node->n_params + 1, instance_and_params, hook->data);
1997               G_LOCK (g_signal_mutex);
1998               if (!was_in_call)
1999                 hook->flags &= ~G_HOOK_FLAG_IN_CALL;
2000               if (need_destroy)
2001                 g_hook_destroy_link (node->emission_hooks, hook);
2002             }
2003           hook = g_hook_next_valid (node->emission_hooks, hook, may_recurse);
2004         }
2005
2006       if (emission_state == EMISSION_RESTART)
2007         goto EMIT_RESTART;
2008     }
2009
2010   if (handler_list)
2011     {
2012       Handler *handler = handler_list;
2013
2014       emission_state = EMISSION_RUN;
2015       handler_ref (handler);
2016       do
2017         {
2018           Handler *tmp;
2019
2020           if (handler->after)
2021             {
2022               handler_unref_R (signal_id, instance, handler_list);
2023               handler_list = handler;
2024               break;
2025             }
2026           else if (!handler->block_count && (!handler->detail || handler->detail == detail) &&
2027                    handler->sequential_number < max_sequential_handler_number)
2028             {
2029               G_UNLOCK (g_signal_mutex);
2030               g_closure_invoke (handler->closure,
2031                                 return_accu,
2032                                 node->n_params + 1,
2033                                 instance_and_params,
2034                                 &ihint);
2035               if (!accumulate (&ihint, emission_return, &accu, accumulator) &&
2036                   emission_state == EMISSION_RUN)
2037                 emission_state = EMISSION_STOP;
2038               G_LOCK (g_signal_mutex);
2039               return_value_altered = TRUE;
2040
2041               tmp = emission_state == EMISSION_RUN ? handler->next : NULL;
2042             }
2043           else
2044             tmp = handler->next;
2045
2046           if (tmp)
2047             handler_ref (tmp);
2048           handler_unref_R (signal_id, instance, handler_list);
2049           handler_list = handler;
2050           handler = tmp;
2051         }
2052       while (handler);
2053
2054       if (emission_state == EMISSION_STOP)
2055         goto EMIT_CLEANUP;
2056       else if (emission_state == EMISSION_RESTART)
2057         goto EMIT_RESTART;
2058     }
2059
2060   ihint.run_type = G_SIGNAL_RUN_LAST;
2061
2062   if ((node->flags & G_SIGNAL_RUN_LAST) && class_closure)
2063     {
2064       emission_state = EMISSION_RUN;
2065
2066       G_UNLOCK (g_signal_mutex);
2067       g_closure_invoke (class_closure,
2068                         return_accu,
2069                         node->n_params + 1,
2070                         instance_and_params,
2071                         &ihint);
2072       if (!accumulate (&ihint, emission_return, &accu, accumulator) &&
2073           emission_state == EMISSION_RUN)
2074         emission_state = EMISSION_STOP;
2075       G_LOCK (g_signal_mutex);
2076       return_value_altered = TRUE;
2077
2078       if (emission_state == EMISSION_STOP)
2079         goto EMIT_CLEANUP;
2080       else if (emission_state == EMISSION_RESTART)
2081         goto EMIT_RESTART;
2082     }
2083
2084   if (handler_list)
2085     {
2086       Handler *handler = handler_list;
2087
2088       emission_state = EMISSION_RUN;
2089       handler_ref (handler);
2090       do
2091         {
2092           Handler *tmp;
2093
2094           if (handler->after && !handler->block_count && (!handler->detail || handler->detail == detail) &&
2095               handler->sequential_number < max_sequential_handler_number)
2096             {
2097               G_UNLOCK (g_signal_mutex);
2098               g_closure_invoke (handler->closure,
2099                                 return_accu,
2100                                 node->n_params + 1,
2101                                 instance_and_params,
2102                                 &ihint);
2103               if (!accumulate (&ihint, emission_return, &accu, accumulator) &&
2104                   emission_state == EMISSION_RUN)
2105                 emission_state = EMISSION_STOP;
2106               G_LOCK (g_signal_mutex);
2107               return_value_altered = TRUE;
2108
2109               tmp = emission_state == EMISSION_RUN ? handler->next : NULL;
2110             }
2111           else
2112             tmp = handler->next;
2113
2114           if (tmp)
2115             handler_ref (tmp);
2116           handler_unref_R (signal_id, instance, handler);
2117           handler = tmp;
2118         }
2119       while (handler);
2120
2121       if (emission_state == EMISSION_STOP)
2122         goto EMIT_CLEANUP;
2123       else if (emission_state == EMISSION_RESTART)
2124         goto EMIT_RESTART;
2125     }
2126
2127  EMIT_CLEANUP:
2128
2129   ihint.run_type = G_SIGNAL_RUN_CLEANUP;
2130
2131   if ((node->flags & G_SIGNAL_RUN_CLEANUP) && class_closure)
2132     {
2133       gboolean need_unset = FALSE;
2134
2135       emission_state = EMISSION_STOP;
2136
2137       G_UNLOCK (g_signal_mutex);
2138       if (node->return_type != G_TYPE_NONE && !accumulator)
2139         {
2140           g_value_init (&accu, node->return_type & ~G_SIGNAL_TYPE_STATIC_SCOPE);
2141           need_unset = TRUE;
2142         }
2143       g_closure_invoke (class_closure,
2144                         node->return_type != G_TYPE_NONE ? &accu : NULL,
2145                         node->n_params + 1,
2146                         instance_and_params,
2147                         &ihint);
2148       if (need_unset)
2149         g_value_unset (&accu);
2150       G_LOCK (g_signal_mutex);
2151
2152       if (emission_state == EMISSION_RESTART)
2153         goto EMIT_RESTART;
2154     }
2155
2156   if (handler_list)
2157     handler_unref_R (signal_id, instance, handler_list);
2158
2159   emission_pop ((node->flags & G_SIGNAL_NO_RECURSE) ? &g_restart_emissions : &g_recursive_emissions, &emission_state);
2160   if (accumulator)
2161     g_value_unset (&accu);
2162
2163   return return_value_altered;
2164 }
2165
2166
2167 /* --- compile standard marshallers --- */
2168 #include        "gobject.h"
2169 #include        "genums.h"
2170 #include        "gmarshal.c"