1 /* GObject - GLib Type, Object, Parameter and Signal Library
2 * Copyright (C) 1998-1999, 2000-2001 Tim Janik and Red Hat, Inc.
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Lesser General Public
6 * License as published by the Free Software Foundation; either
7 * version 2 of the License, or (at your option) any later version.
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Lesser General Public License for more details.
14 * You should have received a copy of the GNU Lesser General
15 * Public License along with this library; if not, write to the
16 * Free Software Foundation, Inc., 59 Temple Place, Suite 330,
17 * Boston, MA 02111-1307, USA.
20 #ifndef __G_OBJECT_NOTIFY_QUEUE_H__
21 #define __G_OBJECT_NOTIFY_QUEUE_H__
23 #include <string.h> /* memset */
25 #include <glib-object.h>
30 /* --- typedefs --- */
31 typedef struct _GObjectNotifyContext GObjectNotifyContext
;
32 typedef struct _GObjectNotifyQueue GObjectNotifyQueue
;
33 typedef void (*GObjectNotifyQueueDispatcher
) (GObject
*object
,
38 /* --- structures --- */
39 struct _GObjectNotifyContext
41 GQuark quark_notify_queue
;
42 GObjectNotifyQueueDispatcher dispatcher
;
43 GTrashStack
*_nqueue_trash
; /* unused */
45 struct _GObjectNotifyQueue
47 GObjectNotifyContext
*context
;
53 G_LOCK_DEFINE_STATIC(notify_lock
);
55 /* --- functions --- */
57 g_object_notify_queue_free (gpointer data
)
59 GObjectNotifyQueue
*nqueue
= data
;
61 g_slist_free (nqueue
->pspecs
);
62 g_slice_free (GObjectNotifyQueue
, nqueue
);
65 static inline GObjectNotifyQueue
*
66 g_object_notify_queue_freeze (GObject
*object
,
67 GObjectNotifyContext
*context
)
69 GObjectNotifyQueue
*nqueue
;
72 nqueue
= g_datalist_id_get_data (&object
->qdata
, context
->quark_notify_queue
);
75 nqueue
= g_slice_new0 (GObjectNotifyQueue
);
76 nqueue
->context
= context
;
77 g_datalist_id_set_data_full (&object
->qdata
, context
->quark_notify_queue
,
78 nqueue
, g_object_notify_queue_free
);
81 if (nqueue
->freeze_count
>= 65535)
82 g_critical("Free queue for %s (%p) is larger than 65535,"
83 " called g_object_freeze_notify() too often."
84 " Forgot to call g_object_thaw_notify() or infinite loop",
85 G_OBJECT_TYPE_NAME (object
), object
);
87 nqueue
->freeze_count
++;
88 G_UNLOCK(notify_lock
);
94 g_object_notify_queue_thaw (GObject
*object
,
95 GObjectNotifyQueue
*nqueue
)
97 GObjectNotifyContext
*context
= nqueue
->context
;
98 GParamSpec
*pspecs_mem
[16], **pspecs
, **free_me
= NULL
;
102 g_return_if_fail (nqueue
->freeze_count
> 0);
103 g_return_if_fail (g_atomic_int_get(&object
->ref_count
) > 0);
107 /* Just make sure we never get into some nasty race condition */
108 if (G_UNLIKELY(nqueue
->freeze_count
== 0)) {
109 G_UNLOCK(notify_lock
);
110 g_warning ("%s: property-changed notification for %s(%p) is not frozen",
111 G_STRFUNC
, G_OBJECT_TYPE_NAME (object
), object
);
115 nqueue
->freeze_count
--;
116 if (nqueue
->freeze_count
) {
117 G_UNLOCK(notify_lock
);
121 pspecs
= nqueue
->n_pspecs
> 16 ? free_me
= g_new (GParamSpec
*, nqueue
->n_pspecs
) : pspecs_mem
;
122 /* set first entry to NULL since it's checked unconditionally */
124 for (slist
= nqueue
->pspecs
; slist
; slist
= slist
->next
)
126 GParamSpec
*pspec
= slist
->data
;
129 /* dedup, make pspecs in the list unique */
130 for (i
= 0; i
< n_pspecs
; i
++)
132 if (pspecs
[i
] == pspec
)
136 if (i
== n_pspecs
) /* if no match was found */
137 pspecs
[n_pspecs
++] = pspec
;
139 g_datalist_id_set_data (&object
->qdata
, context
->quark_notify_queue
, NULL
);
141 G_UNLOCK(notify_lock
);
144 context
->dispatcher (object
, n_pspecs
, pspecs
);
149 g_object_notify_queue_clear (GObject
*object
,
150 GObjectNotifyQueue
*nqueue
)
152 g_return_if_fail (nqueue
->freeze_count
> 0);
156 g_slist_free (nqueue
->pspecs
);
157 nqueue
->pspecs
= NULL
;
158 nqueue
->n_pspecs
= 0;
160 G_UNLOCK(notify_lock
);
164 g_object_notify_queue_add (GObject
*object
,
165 GObjectNotifyQueue
*nqueue
,
168 if (pspec
->flags
& G_PARAM_READABLE
)
170 GParamSpec
*redirect
;
174 g_return_if_fail (nqueue
->n_pspecs
< 65535);
176 redirect
= g_param_spec_get_redirect_target (pspec
);
180 /* we do the deduping in _thaw */
181 nqueue
->pspecs
= g_slist_prepend (nqueue
->pspecs
, pspec
);
184 G_UNLOCK(notify_lock
);
188 /* NB: This function is not threadsafe, do not ever use it if
189 * you need a threadsafe notify queue.
190 * Use g_object_notify_queue_freeze() to acquire the queue and
191 * g_object_notify_queue_thaw() after you are done instead.
193 static inline GObjectNotifyQueue
*
194 g_object_notify_queue_from_object (GObject
*object
,
195 GObjectNotifyContext
*context
)
197 return g_datalist_id_get_data (&object
->qdata
, context
->quark_notify_queue
);
202 #endif /* __G_OBJECT_NOTIFY_QUEUE_H__ */