glib/glib/gmain.h
changeset 18 47c74d1534e1
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/glib/glib/gmain.h	Fri Apr 16 16:46:38 2010 +0300
@@ -0,0 +1,308 @@
+/* gmain.h - the GLib Main loop
+ * Copyright (C) 1998-2000 Red Hat, Inc.
+ * Portions copyright (c) 2006-2009 Nokia Corporation.  All rights reserved.
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Library General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.	 See the GNU
+ * Library General Public License for more details.
+ *
+ * You should have received a copy of the GNU Library General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+#if defined(G_DISABLE_SINGLE_INCLUDES) && !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION)
+#error "Only <glib.h> can be included directly."
+#endif
+
+#ifndef __G_MAIN_H__
+#define __G_MAIN_H__
+
+#include <glib/gpoll.h>
+#include <glib/gslist.h>
+#include <glib/gthread.h>
+
+G_BEGIN_DECLS
+
+typedef struct _GMainContext	        GMainContext;	/* Opaque */
+typedef struct _GMainLoop	        GMainLoop;	/* Opaque */
+typedef struct _GSource	                GSource;
+typedef struct _GSourceCallbackFuncs	GSourceCallbackFuncs;
+typedef struct _GSourceFuncs	        GSourceFuncs;
+
+typedef gboolean (*GSourceFunc)       (gpointer data);
+typedef void     (*GChildWatchFunc)   (GPid     pid,
+				       gint     status,
+				       gpointer data);
+struct _GSource
+{
+  /*< private >*/
+  gpointer callback_data;
+  GSourceCallbackFuncs *callback_funcs;
+
+  GSourceFuncs *source_funcs;
+  guint ref_count;
+
+  GMainContext *context;
+
+  gint priority;
+  guint flags;
+  guint source_id;
+
+  GSList *poll_fds;
+  
+  GSource *prev;
+  GSource *next;
+
+  gpointer reserved1;
+  gpointer reserved2;
+};
+
+struct _GSourceCallbackFuncs
+{
+  void (*ref)   (gpointer     cb_data);
+  void (*unref) (gpointer     cb_data);
+  void (*get)   (gpointer     cb_data,
+		 GSource     *source, 
+		 GSourceFunc *func,
+		 gpointer    *data);
+};
+
+typedef void (*GSourceDummyMarshal) (void);
+
+struct _GSourceFuncs
+{
+  gboolean (*prepare)  (GSource    *source,
+			gint       *timeout_);
+  gboolean (*check)    (GSource    *source);
+  gboolean (*dispatch) (GSource    *source,
+			GSourceFunc callback,
+			gpointer    user_data);
+  void     (*finalize) (GSource    *source); /* Can be NULL */
+
+  /* For use by g_source_set_closure */
+  GSourceFunc     closure_callback;	   
+  GSourceDummyMarshal closure_marshal; /* Really is of type GClosureMarshal */
+};
+
+/* Standard priorities */
+
+#define G_PRIORITY_HIGH            -100
+#define G_PRIORITY_DEFAULT          0
+#define G_PRIORITY_HIGH_IDLE        100
+#define G_PRIORITY_DEFAULT_IDLE     200
+#define G_PRIORITY_LOW	            300
+
+/* GMainContext: */
+
+IMPORT_C GMainContext *g_main_context_new       (void);
+IMPORT_C GMainContext *g_main_context_ref       (GMainContext *context);
+IMPORT_C void          g_main_context_unref     (GMainContext *context);
+IMPORT_C GMainContext *g_main_context_default   (void);
+
+IMPORT_C gboolean      g_main_context_iteration (GMainContext *context,
+					gboolean      may_block);
+IMPORT_C gboolean      g_main_context_pending   (GMainContext *context);
+
+/* For implementation of legacy interfaces
+ */
+IMPORT_C GSource      *g_main_context_find_source_by_id              (GMainContext *context,
+							     guint         source_id);
+IMPORT_C GSource      *g_main_context_find_source_by_user_data       (GMainContext *context,
+							     gpointer      user_data);
+IMPORT_C GSource      *g_main_context_find_source_by_funcs_user_data (GMainContext *context,
+ 							     GSourceFuncs *funcs,
+							     gpointer      user_data);
+
+/* Low level functions for implementing custom main loops.
+ */
+IMPORT_C void     g_main_context_wakeup  (GMainContext *context);
+IMPORT_C gboolean g_main_context_acquire (GMainContext *context);
+IMPORT_C void     g_main_context_release (GMainContext *context);
+IMPORT_C gboolean g_main_context_is_owner (GMainContext *context);
+IMPORT_C gboolean g_main_context_wait    (GMainContext *context,
+				 GCond        *cond,
+				 GMutex       *mutex);
+
+IMPORT_C gboolean g_main_context_prepare  (GMainContext *context,
+				  gint         *priority);
+IMPORT_C gint     g_main_context_query    (GMainContext *context,
+				  gint          max_priority,
+				  gint         *timeout_,
+				  GPollFD      *fds,
+				  gint          n_fds);
+IMPORT_C gint     g_main_context_check    (GMainContext *context,
+				  gint          max_priority,
+				  GPollFD      *fds,
+				  gint          n_fds);
+IMPORT_C void     g_main_context_dispatch (GMainContext *context);
+
+IMPORT_C void      g_main_context_set_poll_func (GMainContext *context,
+					GPollFunc     func);
+IMPORT_C GPollFunc g_main_context_get_poll_func (GMainContext *context);
+
+/* Low level functions for use by source implementations
+ */
+IMPORT_C void g_main_context_add_poll      (GMainContext *context,
+				   GPollFD      *fd,
+				   gint          priority);
+IMPORT_C void g_main_context_remove_poll   (GMainContext *context,
+				   GPollFD      *fd);
+
+IMPORT_C gint     g_main_depth               (void);
+IMPORT_C GSource *g_main_current_source      (void);
+
+
+/* GMainLoop: */
+
+IMPORT_C GMainLoop *g_main_loop_new        (GMainContext *context,
+			    	   gboolean      is_running);
+IMPORT_C void       g_main_loop_run        (GMainLoop    *loop);
+IMPORT_C void       g_main_loop_quit       (GMainLoop    *loop);
+IMPORT_C GMainLoop *g_main_loop_ref        (GMainLoop    *loop);
+IMPORT_C void       g_main_loop_unref      (GMainLoop    *loop);
+IMPORT_C gboolean   g_main_loop_is_running (GMainLoop    *loop);
+IMPORT_C GMainContext *g_main_loop_get_context (GMainLoop    *loop);
+
+/* GSource: */
+
+IMPORT_C GSource *g_source_new             (GSourceFuncs   *source_funcs,
+				   guint           struct_size);
+IMPORT_C GSource *g_source_ref             (GSource        *source);
+IMPORT_C void     g_source_unref           (GSource        *source);
+
+IMPORT_C guint    g_source_attach          (GSource        *source,
+				   GMainContext   *context);
+IMPORT_C void     g_source_destroy         (GSource        *source);
+
+IMPORT_C void     g_source_set_priority    (GSource        *source,
+				   gint            priority);
+IMPORT_C gint     g_source_get_priority    (GSource        *source);
+IMPORT_C void     g_source_set_can_recurse (GSource        *source,
+				   gboolean        can_recurse);
+IMPORT_C gboolean g_source_get_can_recurse (GSource        *source);
+IMPORT_C guint    g_source_get_id          (GSource        *source);
+
+IMPORT_C GMainContext *g_source_get_context (GSource       *source);
+
+IMPORT_C void g_source_set_callback          (GSource              *source,
+				     GSourceFunc           func,
+				     gpointer              data,
+				     GDestroyNotify        notify);
+
+IMPORT_C void     g_source_set_funcs       (GSource        *source,
+                                   GSourceFuncs   *funcs);
+IMPORT_C gboolean g_source_is_destroyed    (GSource        *source);
+
+/* Used to implement g_source_connect_closure and internally*/
+IMPORT_C void g_source_set_callback_indirect (GSource              *source,
+				     gpointer              callback_data,
+				     GSourceCallbackFuncs *callback_funcs);
+
+IMPORT_C void     g_source_add_poll         (GSource        *source,
+				    GPollFD        *fd);
+IMPORT_C void     g_source_remove_poll      (GSource        *source,
+				    GPollFD        *fd);
+
+IMPORT_C void     g_source_get_current_time (GSource        *source,
+				    GTimeVal       *timeval);
+
+ /* void g_source_connect_closure (GSource        *source,
+                                  GClosure       *closure);
+ */
+
+/* Specific source types
+ */
+IMPORT_C GSource *g_idle_source_new        (void);
+IMPORT_C GSource *g_child_watch_source_new (GPid pid);
+IMPORT_C GSource *g_timeout_source_new     (guint interval);
+IMPORT_C GSource *g_timeout_source_new_seconds (guint interval);
+
+/* Miscellaneous functions
+ */
+IMPORT_C void g_get_current_time		        (GTimeVal	*result);
+
+/* ============== Compat main loop stuff ================== */
+
+#ifndef G_DISABLE_DEPRECATED
+
+/* Legacy names for GMainLoop functions
+ */
+#define 	g_main_new(is_running)	g_main_loop_new (NULL, is_running);
+#define         g_main_run(loop)        g_main_loop_run(loop)
+#define         g_main_quit(loop)       g_main_loop_quit(loop)
+#define         g_main_destroy(loop)    g_main_loop_unref(loop)
+#define         g_main_is_running(loop) g_main_loop_is_running(loop)
+
+/* Functions to manipulate the default main loop
+ */
+
+#define	g_main_iteration(may_block) g_main_context_iteration      (NULL, may_block)
+#define g_main_pending()            g_main_context_pending        (NULL)
+
+#define g_main_set_poll_func(func)   g_main_context_set_poll_func (NULL, func)
+
+#endif /* G_DISABLE_DEPRECATED */
+
+/* Source manipulation by ID */
+IMPORT_C gboolean g_source_remove                     (guint          tag);
+IMPORT_C gboolean g_source_remove_by_user_data        (gpointer       user_data);
+IMPORT_C gboolean g_source_remove_by_funcs_user_data  (GSourceFuncs  *funcs,
+					      gpointer       user_data);
+
+/* Idles, child watchers and timeouts */
+IMPORT_C guint    g_timeout_add_full     (gint            priority,
+				     guint           interval,
+				     GSourceFunc     function,
+				     gpointer        data,
+				     GDestroyNotify  notify);
+IMPORT_C guint    g_timeout_add          (guint           interval,
+				     GSourceFunc     function,
+				     gpointer        data);
+IMPORT_C guint    g_timeout_add_seconds_full (gint            priority,
+                                     guint           interval,
+                                     GSourceFunc     function,
+                                     gpointer        data,
+                                     GDestroyNotify  notify);
+IMPORT_C guint    g_timeout_add_seconds      (guint           interval,
+				     GSourceFunc     function,
+				     gpointer        data);
+IMPORT_C guint    g_child_watch_add_full     (gint            priority,
+				     GPid            pid,
+				     GChildWatchFunc function,
+				     gpointer        data,
+				     GDestroyNotify  notify);
+IMPORT_C guint    g_child_watch_add          (GPid            pid,
+				     GChildWatchFunc function,
+				     gpointer        data);
+IMPORT_C guint    g_idle_add                 (GSourceFunc     function,
+				     gpointer        data);
+IMPORT_C guint    g_idle_add_full            (gint            priority,
+				     GSourceFunc     function,
+				     gpointer        data,
+				     GDestroyNotify  notify);
+IMPORT_C gboolean g_idle_remove_by_data      (gpointer        data);
+
+/* Hook for GClosure / GSource integration. Don't touch */
+#ifdef __SYMBIAN32__
+IMPORT_C GSourceFuncs * _g_timeout_funcs(void);
+#endif /*__SYMBIAN32__ */
+GLIB_VAR GSourceFuncs g_timeout_funcs;
+#ifdef __SYMBIAN32__
+IMPORT_C GSourceFuncs * _g_child_watch_funcs(void);
+#endif /* __SYMBIAN32__ */
+GLIB_VAR GSourceFuncs g_child_watch_funcs;
+#ifdef __SYMBIAN32__
+IMPORT_C GSourceFuncs * _g_idle_funcs(void);
+#endif/* __SYMBIAN32__ */
+GLIB_VAR GSourceFuncs g_idle_funcs;
+
+G_END_DECLS
+
+#endif /* __G_MAIN_H__ */