1 /* -*- mode: C; c-file-style: "gnu" -*- */
2 /* dbus-timeout.c DBusTimeout implementation
4 * Copyright (C) 2003 CodeFactory AB
6 * Licensed under the Academic Free License version 1.2
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation; either version 2 of the License, or
11 * (at your option) any later version.
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
18 * You should have received a copy of the GNU General Public License
19 * along with this program; if not, write to the Free Software
20 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
24 #include "dbus-internals.h"
25 #include "dbus-timeout.h"
26 #include "dbus-list.h"
29 * @defgroup DBusTimeoutInternals DBusTimeout implementation details
30 * @ingroup DBusInternals
31 * @brief implementation details for DBusTimeout
38 int refcount; /**< Reference count */
39 int interval; /**< Timeout interval in milliseconds. */
41 DBusTimeoutHandler handler; /**< Timeout handler. */
42 void *handler_data; /**< Timeout handler data. */
43 DBusFreeFunction free_handler_data_function; /**< Free the timeout handler data. */
45 void *data; /**< Application data. */
46 DBusFreeFunction free_data_function; /**< Free the application data. */
50 * Creates a new DBusTimeout.
51 * @param interval the timeout interval in milliseconds.
52 * @param handler function to call when the timeout occurs.
53 * @param data data to pass to the handler
54 * @param free_data_function function to be called to free the data.
55 * @returns the new DBusTimeout object,
58 _dbus_timeout_new (int interval,
59 DBusTimeoutHandler handler,
61 DBusFreeFunction free_data_function)
65 timeout = dbus_new0 (DBusTimeout, 1);
66 timeout->refcount = 1;
67 timeout->interval = interval;
69 timeout->handler = handler;
70 timeout->handler_data = data;
71 timeout->free_handler_data_function = free_data_function;
77 * Increments the reference count of a DBusTimeout object.
79 * @param timeout the timeout object.
82 _dbus_timeout_ref (DBusTimeout *timeout)
84 timeout->refcount += 1;
88 * Decrements the reference count of a DBusTimeout object
89 * and finalizes the object if the count reaches zero.
91 * @param timeout the timeout object.
94 _dbus_timeout_unref (DBusTimeout *timeout)
96 _dbus_assert (timeout != NULL);
97 _dbus_assert (timeout->refcount > 0);
99 timeout->refcount -= 1;
100 if (timeout->refcount == 0)
102 dbus_timeout_set_data (timeout, NULL, NULL); /* call free_data_function */
104 if (timeout->free_handler_data_function)
105 (* timeout->free_handler_data_function) (timeout->handler_data);
112 * @typedef DBusTimeoutList
114 * Opaque data type representing a list of timeouts
115 * and a set of DBusAddTimeoutFunction/DBusRemoveTimeoutFunction.
116 * Automatically handles removing/re-adding timeouts
117 * when the DBusAddTimeoutFunction is updated or changed.
118 * Holds a reference count to each timeout.
123 * DBusTimeoutList implementation details. All fields
127 struct DBusTimeoutList
129 DBusList *timeouts; /**< Timeout objects. */
131 DBusAddTimeoutFunction add_timeout_function; /**< Callback for adding a timeout. */
132 DBusRemoveTimeoutFunction remove_timeout_function; /**< Callback for removing a timeout. */
133 void *timeout_data; /**< Data for timeout callbacks */
134 DBusFreeFunction timeout_free_data_function; /**< Free function for timeout callback data */
138 * Creates a new timeout list. Returns #NULL if insufficient
141 * @returns the new timeout list, or #NULL on failure.
144 _dbus_timeout_list_new (void)
146 DBusTimeoutList *timeout_list;
148 timeout_list = dbus_new0 (DBusTimeoutList, 1);
149 if (timeout_list == NULL)
156 * Frees a DBusTimeoutList.
158 * @param timeout_list the timeout list.
161 _dbus_timeout_list_free (DBusTimeoutList *timeout_list)
163 /* free timeout_data and remove timeouts as a side effect */
164 _dbus_timeout_list_set_functions (timeout_list,
165 NULL, NULL, NULL, NULL);
167 _dbus_list_foreach (&timeout_list->timeouts,
168 (DBusForeachFunction) _dbus_timeout_unref,
170 _dbus_list_clear (&timeout_list->timeouts);
172 dbus_free (timeout_list);
176 * Sets the timeout functions. This function is the "backend"
177 * for dbus_connection_set_timeout_functions().
179 * @param timeout_list the timeout list
180 * @param add_function the add timeout function.
181 * @param remove_function the remove timeout function.
182 * @param data the data for those functions.
183 * @param free_data_function the function to free the data.
184 * @returns #FALSE if no memory
188 _dbus_timeout_list_set_functions (DBusTimeoutList *timeout_list,
189 DBusAddTimeoutFunction add_function,
190 DBusRemoveTimeoutFunction remove_function,
192 DBusFreeFunction free_data_function)
194 /* Add timeouts with the new function, failing on OOM */
195 if (add_function != NULL)
199 link = _dbus_list_get_first_link (&timeout_list->timeouts);
202 DBusList *next = _dbus_list_get_next_link (&timeout_list->timeouts,
205 if (!(* add_function) (link->data, data))
207 /* remove it all again and return FALSE */
210 link2 = _dbus_list_get_first_link (&timeout_list->timeouts);
211 while (link2 != link)
213 DBusList *next = _dbus_list_get_next_link (&timeout_list->timeouts,
216 (* remove_function) (link2->data, data);
228 /* Remove all current timeouts from previous timeout handlers */
230 if (timeout_list->remove_timeout_function != NULL)
232 _dbus_list_foreach (&timeout_list->timeouts,
233 (DBusForeachFunction) timeout_list->remove_timeout_function,
234 timeout_list->timeout_data);
237 if (timeout_list->timeout_free_data_function != NULL)
238 (* timeout_list->timeout_free_data_function) (timeout_list->timeout_data);
240 timeout_list->add_timeout_function = add_function;
241 timeout_list->remove_timeout_function = remove_function;
242 timeout_list->timeout_data = data;
243 timeout_list->timeout_free_data_function = free_data_function;
249 * Adds a new timeout to the timeout list, invoking the
250 * application DBusAddTimeoutFunction if appropriate.
252 * @param timeout_list the timeout list.
253 * @param timeout the timeout to add.
254 * @returns #TRUE on success, #FALSE If no memory.
257 _dbus_timeout_list_add_timeout (DBusTimeoutList *timeout_list,
258 DBusTimeout *timeout)
260 if (!_dbus_list_append (&timeout_list->timeouts, timeout))
263 _dbus_timeout_ref (timeout);
265 if (timeout_list->add_timeout_function != NULL)
267 if (!(* timeout_list->add_timeout_function) (timeout,
268 timeout_list->timeout_data))
270 _dbus_list_remove_last (&timeout_list->timeouts, timeout);
271 _dbus_timeout_unref (timeout);
280 * Removes a timeout from the timeout list, invoking the
281 * application's DBusRemoveTimeoutFunction if appropriate.
283 * @param timeout_list the timeout list.
284 * @param timeout the timeout to remove.
287 _dbus_timeout_list_remove_timeout (DBusTimeoutList *timeout_list,
288 DBusTimeout *timeout)
290 if (!_dbus_list_remove (&timeout_list->timeouts, timeout))
291 _dbus_assert_not_reached ("Nonexistent timeout was removed");
293 if (timeout_list->remove_timeout_function != NULL)
294 (* timeout_list->remove_timeout_function) (timeout,
295 timeout_list->timeout_data);
297 _dbus_timeout_unref (timeout);
303 * @defgroup DBusTimeout DBusTimeout
305 * @brief Object representing a timeout
307 * Types and functions related to DBusTimeout. A timeout
308 * represents a timeout that the main loop needs to monitor,
309 * as in Qt's QTimer or GLib's g_timeout_add().
316 * @typedef DBusTimeout
318 * Opaque object representing a timeout.
322 * Gets the timeout interval.
323 * @param timeout the DBusTimeout object.
324 * @returns the interval in milliseconds.
327 dbus_timeout_get_interval (DBusTimeout *timeout)
329 return timeout->interval;
333 * Gets data previously set with dbus_timeout_set_data()
336 * @param timeout the DBusTimeout object.
337 * @returns previously-set data.
340 dbus_timeout_get_data (DBusTimeout *timeout)
342 return timeout->data;
346 * Sets data which can be retrieved with dbus_timeout_get_data().
347 * Intended for use by the DBusAddTimeoutFunction and
348 * DBusRemoveTimeoutFunction to store their own data. For example with
349 * Qt you might store the QTimer for this timeout and with GLib
350 * you might store a g_timeout_add result id.
352 * @param timeout the DBusTimeout object.
353 * @param data the data.
354 * @param free_data_function function to be called to free the data.
357 dbus_timeout_set_data (DBusTimeout *timeout,
359 DBusFreeFunction free_data_function)
361 if (timeout->free_data_function != NULL)
362 (* timeout->free_data_function) (timeout->data);
364 timeout->data = data;
365 timeout->free_data_function = free_data_function;
369 * Calls the timeout handler for this timeout.
370 * This function should be called when the timeout
373 * @param timeout the DBusTimeout object.
376 dbus_timeout_handle (DBusTimeout *timeout)
378 (* timeout->handler) (timeout->handler_data);