Gecko [ naturenectar.co.uk ]

Name	Size	Permission	Date
deprecated	[ DIR ]	drwxr-xr-x	2025-08-15 18:22
galloca.h	3.82 KB	-rw-r--r--	2021-08-19 15:27
garray.h	11.12 KB	-rw-r--r--	2021-08-19 15:27
gasyncqueue.h	5.59 KB	-rw-r--r--	2021-08-19 15:27
gatomic.h	26.57 KB	-rw-r--r--	2021-08-19 15:27
gbacktrace.h	2.73 KB	-rw-r--r--	2021-08-19 15:27
gbase64.h	2.27 KB	-rw-r--r--	2021-08-19 15:27
gbitlock.h	2.83 KB	-rw-r--r--	2021-08-19 15:27
gbookmarkfile.h	12.33 KB	-rw-r--r--	2021-08-19 15:27
gbytes.h	3.26 KB	-rw-r--r--	2021-08-19 15:27
gcharset.h	1.54 KB	-rw-r--r--	2021-08-19 15:27
gchecksum.h	3.77 KB	-rw-r--r--	2021-08-19 15:27
gconvert.h	5.78 KB	-rw-r--r--	2021-08-19 15:27
gdataset.h	6.1 KB	-rw-r--r--	2021-08-19 15:27
gdate.h	12.13 KB	-rw-r--r--	2021-08-19 15:27
gdatetime.h	12.44 KB	-rw-r--r--	2021-08-19 15:27
gdir.h	1.6 KB	-rw-r--r--	2021-08-19 15:27
genviron.h	2.31 KB	-rw-r--r--	2021-08-19 15:27
gerror.h	10.88 KB	-rw-r--r--	2021-08-19 15:27
gfileutils.h	7.68 KB	-rw-r--r--	2021-08-19 15:27
ggettext.h	2.37 KB	-rw-r--r--	2021-08-19 15:27
ghash.h	7.7 KB	-rw-r--r--	2021-08-19 15:27
ghmac.h	3.39 KB	-rw-r--r--	2021-08-19 15:27
ghook.h	6.21 KB	-rw-r--r--	2021-08-19 15:27
ghostutils.h	1.42 KB	-rw-r--r--	2021-08-19 15:27
gi18n-lib.h	1.34 KB	-rw-r--r--	2021-08-19 15:27
gi18n.h	1.14 KB	-rw-r--r--	2021-08-19 15:27
giochannel.h	13.63 KB	-rw-r--r--	2021-08-19 15:27
gkeyfile.h	14.56 KB	-rw-r--r--	2021-08-19 15:27
glib-autocleanups.h	4.79 KB	-rw-r--r--	2021-08-19 15:27
glist.h	6.77 KB	-rw-r--r--	2021-08-19 15:27
gmacros.h	45.12 KB	-rw-r--r--	2021-08-19 15:27
gmain.h	27.55 KB	-rw-r--r--	2021-08-19 15:27
gmappedfile.h	1.94 KB	-rw-r--r--	2021-08-19 15:27
gmarkup.h	10.62 KB	-rw-r--r--	2021-08-19 15:27
gmem.h	14.51 KB	-rw-r--r--	2021-08-19 15:27
gmessages.h	26.56 KB	-rw-r--r--	2021-08-19 15:27
gnode.h	8.5 KB	-rw-r--r--	2021-08-19 15:27
goption.h	15.72 KB	-rw-r--r--	2021-08-19 15:27
gpattern.h	1.74 KB	-rw-r--r--	2021-08-19 15:27
gpoll.h	4.03 KB	-rw-r--r--	2021-08-19 15:27
gprimes.h	1.65 KB	-rw-r--r--	2021-08-19 15:27
gprintf.h	1.94 KB	-rw-r--r--	2021-08-19 15:27
gqsort.h	1.46 KB	-rw-r--r--	2021-08-19 15:27
gquark.h	2.63 KB	-rw-r--r--	2021-08-19 15:27
gqueue.h	7.57 KB	-rw-r--r--	2021-08-19 15:27
grand.h	3.11 KB	-rw-r--r--	2021-08-19 15:27
grcbox.h	3.9 KB	-rw-r--r--	2021-08-19 15:27
grefcount.h	3.89 KB	-rw-r--r--	2021-08-19 15:27
grefstring.h	1.82 KB	-rw-r--r--	2021-08-19 15:27
gregex.h	27.44 KB	-rw-r--r--	2021-08-19 15:27
gscanner.h	8.65 KB	-rw-r--r--	2021-08-19 15:27
gsequence.h	8.6 KB	-rw-r--r--	2021-08-19 15:27
gshell.h	1.71 KB	-rw-r--r--	2021-08-19 15:27
gslice.h	4.48 KB	-rw-r--r--	2021-08-19 15:27
gslist.h	6.4 KB	-rw-r--r--	2021-08-19 15:27
gspawn.h	12.89 KB	-rw-r--r--	2021-08-19 15:27
gstdio.h	4.99 KB	-rw-r--r--	2021-08-19 15:27
gstrfuncs.h	13.14 KB	-rw-r--r--	2021-08-19 15:27
gstring.h	8.14 KB	-rw-r--r--	2021-08-19 15:27
gstringchunk.h	2.08 KB	-rw-r--r--	2021-08-19 15:27
gstrvbuilder.h	1.58 KB	-rw-r--r--	2021-08-19 15:27
gtestutils.h	34.31 KB	-rw-r--r--	2021-08-19 15:27
gthread.h	18.32 KB	-rw-r--r--	2021-08-19 15:27
gthreadpool.h	3.73 KB	-rw-r--r--	2021-08-19 15:27
gtimer.h	2.52 KB	-rw-r--r--	2021-08-19 15:27
gtimezone.h	3.81 KB	-rw-r--r--	2021-08-19 15:27
gtrashstack.h	1.86 KB	-rw-r--r--	2021-08-19 15:27
gtree.h	6.3 KB	-rw-r--r--	2021-08-19 15:27
gtypes.h	20.04 KB	-rw-r--r--	2021-08-19 15:27
gunicode.h	40.25 KB	-rw-r--r--	2021-08-19 15:27
guri.h	16.06 KB	-rw-r--r--	2021-08-19 15:27
gutils.h	14.22 KB	-rw-r--r--	2021-08-19 15:27
guuid.h	1.26 KB	-rw-r--r--	2021-08-19 15:27
gvariant.h	28.87 KB	-rw-r--r--	2021-08-19 15:27
gvarianttype.h	12.93 KB	-rw-r--r--	2021-08-19 15:27
gversion.h	1.93 KB	-rw-r--r--	2021-08-19 15:27
gversionmacros.h	46.56 KB	-rw-r--r--	2025-07-15 15:38
gwin32.h	4.56 KB	-rw-r--r--	2021-08-19 15:27

Rename

/* GLIB - Library of useful routines for C programming
 * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 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
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, see <http://www.gnu.org/licenses/>.
 */

/*
 * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
 * file for a list of people on the GLib Team.  See the ChangeLog
 * files for a list of changes.  These files are distributed with
 * GLib at ftp://ftp.gtk.org/pub/gtk/.
 */

#ifndef __G_HOOK_H__
#define __G_HOOK_H__

#if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION)
#error "Only <glib.h> can be included directly."
#endif

#include <glib/gmem.h>

G_BEGIN_DECLS

/* --- typedefs --- */
typedef struct _GHook		GHook;
typedef struct _GHookList	GHookList;

typedef gint		(*GHookCompareFunc)	(GHook		*new_hook,
						 GHook		*sibling);
typedef gboolean	(*GHookFindFunc)	(GHook		*hook,
						 gpointer	 data);
typedef void		(*GHookMarshaller)	(GHook		*hook,
						 gpointer	 marshal_data);
typedef gboolean	(*GHookCheckMarshaller)	(GHook		*hook,
						 gpointer	 marshal_data);
typedef void		(*GHookFunc)		(gpointer	 data);
typedef gboolean	(*GHookCheckFunc)	(gpointer	 data);
typedef void		(*GHookFinalizeFunc)	(GHookList      *hook_list,
						 GHook          *hook);
typedef enum
{
  G_HOOK_FLAG_ACTIVE	    = 1 << 0,
  G_HOOK_FLAG_IN_CALL	    = 1 << 1,
  G_HOOK_FLAG_MASK	    = 0x0f
} GHookFlagMask;
#define G_HOOK_FLAG_USER_SHIFT	(4)

/* --- structures --- */
struct _GHookList
{
  gulong	    seq_id;
  guint		    hook_size : 16;
  guint		    is_setup : 1;
  GHook		   *hooks;
  gpointer	    dummy3;
  GHookFinalizeFunc finalize_hook;
  gpointer	    dummy[2];
};
struct _GHook
{
  gpointer	 data;
  GHook		*next;
  GHook		*prev;
  guint		 ref_count;
  gulong	 hook_id;
  guint		 flags;
  gpointer	 func;
  GDestroyNotify destroy;
};

/* --- macros --- */
#define	G_HOOK(hook)			((GHook*) (hook))
#define	G_HOOK_FLAGS(hook)		(G_HOOK (hook)->flags)
#define	G_HOOK_ACTIVE(hook)		((G_HOOK_FLAGS (hook) & \
					  G_HOOK_FLAG_ACTIVE) != 0)
#define	G_HOOK_IN_CALL(hook)		((G_HOOK_FLAGS (hook) & \
					  G_HOOK_FLAG_IN_CALL) != 0)
#define G_HOOK_IS_VALID(hook)		(G_HOOK (hook)->hook_id != 0 && \
					 (G_HOOK_FLAGS (hook) & \
                                          G_HOOK_FLAG_ACTIVE))
#define G_HOOK_IS_UNLINKED(hook)	(G_HOOK (hook)->next == NULL && \
					 G_HOOK (hook)->prev == NULL && \
					 G_HOOK (hook)->hook_id == 0 && \
					 G_HOOK (hook)->ref_count == 0)

/* --- prototypes --- */
/* callback maintenance functions */
GLIB_AVAILABLE_IN_ALL
void	 g_hook_list_init		(GHookList		*hook_list,
					 guint			 hook_size);
GLIB_AVAILABLE_IN_ALL
void	 g_hook_list_clear		(GHookList		*hook_list);
GLIB_AVAILABLE_IN_ALL
GHook*	 g_hook_alloc			(GHookList		*hook_list);
GLIB_AVAILABLE_IN_ALL
void	 g_hook_free			(GHookList		*hook_list,
					 GHook			*hook);
GLIB_AVAILABLE_IN_ALL
GHook *	 g_hook_ref			(GHookList		*hook_list,
					 GHook			*hook);
GLIB_AVAILABLE_IN_ALL
void	 g_hook_unref			(GHookList		*hook_list,
					 GHook			*hook);
GLIB_AVAILABLE_IN_ALL
gboolean g_hook_destroy			(GHookList		*hook_list,
					 gulong			 hook_id);
GLIB_AVAILABLE_IN_ALL
void	 g_hook_destroy_link		(GHookList		*hook_list,
					 GHook			*hook);
GLIB_AVAILABLE_IN_ALL
void	 g_hook_prepend			(GHookList		*hook_list,
					 GHook			*hook);
GLIB_AVAILABLE_IN_ALL
void	 g_hook_insert_before		(GHookList		*hook_list,
					 GHook			*sibling,
					 GHook			*hook);
GLIB_AVAILABLE_IN_ALL
void	 g_hook_insert_sorted		(GHookList		*hook_list,
					 GHook			*hook,
					 GHookCompareFunc	 func);
GLIB_AVAILABLE_IN_ALL
GHook*	 g_hook_get			(GHookList		*hook_list,
					 gulong			 hook_id);
GLIB_AVAILABLE_IN_ALL
GHook*	 g_hook_find			(GHookList		*hook_list,
					 gboolean		 need_valids,
					 GHookFindFunc		 func,
					 gpointer		 data);
GLIB_AVAILABLE_IN_ALL
GHook*	 g_hook_find_data		(GHookList		*hook_list,
					 gboolean		 need_valids,
					 gpointer		 data);
GLIB_AVAILABLE_IN_ALL
GHook*	 g_hook_find_func		(GHookList		*hook_list,
					 gboolean		 need_valids,
					 gpointer		 func);
GLIB_AVAILABLE_IN_ALL
GHook*	 g_hook_find_func_data		(GHookList		*hook_list,
					 gboolean		 need_valids,
					 gpointer		 func,
					 gpointer		 data);
/* return the first valid hook, and increment its reference count */
GLIB_AVAILABLE_IN_ALL
GHook*	 g_hook_first_valid		(GHookList		*hook_list,
					 gboolean		 may_be_in_call);
/* return the next valid hook with incremented reference count, and
 * decrement the reference count of the original hook
 */
GLIB_AVAILABLE_IN_ALL
GHook*	 g_hook_next_valid		(GHookList		*hook_list,
					 GHook			*hook,
					 gboolean		 may_be_in_call);
/* GHookCompareFunc implementation to insert hooks sorted by their id */
GLIB_AVAILABLE_IN_ALL
gint	 g_hook_compare_ids		(GHook			*new_hook,
					 GHook			*sibling);
/* convenience macros */
#define	 g_hook_append( hook_list, hook )  \
     g_hook_insert_before ((hook_list), NULL, (hook))
/* invoke all valid hooks with the (*GHookFunc) signature.
 */
GLIB_AVAILABLE_IN_ALL
void	 g_hook_list_invoke		(GHookList		*hook_list,
					 gboolean		 may_recurse);
/* invoke all valid hooks with the (*GHookCheckFunc) signature,
 * and destroy the hook if FALSE is returned.
 */
GLIB_AVAILABLE_IN_ALL
void	 g_hook_list_invoke_check	(GHookList		*hook_list,
					 gboolean		 may_recurse);
/* invoke a marshaller on all valid hooks.
 */
GLIB_AVAILABLE_IN_ALL
void	 g_hook_list_marshal		(GHookList		*hook_list,
					 gboolean		 may_recurse,
					 GHookMarshaller	 marshaller,
					 gpointer		 marshal_data);
GLIB_AVAILABLE_IN_ALL
void	 g_hook_list_marshal_check	(GHookList		*hook_list,
					 gboolean		 may_recurse,
					 GHookCheckMarshaller	 marshaller,
					 gpointer		 marshal_data);

G_END_DECLS

#endif /* __G_HOOK_H__ */