📄 glib-hook-functions.html
字号:
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"><html><head><meta http-equiv="Content-Type" content="text/html; charset=US-ASCII"><title>Hook Functions</title><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"><link rel="start" href="index.html" title="GLib Reference Manual"><link rel="up" href="glib-utilities.html" title="GLib Utilities"><link rel="prev" href="glib-Random-Numbers.html" title="Random Numbers"><link rel="next" href="glib-Miscellaneous-Utility-Functions.html" title="Miscellaneous Utility Functions"><meta name="generator" content="GTK-Doc V1.9 (XML mode)"><link rel="stylesheet" href="style.css" type="text/css"><link rel="chapter" href="glib.html" title="GLib Overview"><link rel="chapter" href="glib-fundamentals.html" title="GLib Fundamentals"><link rel="chapter" href="glib-core.html" title="GLib Core Application Support"><link rel="chapter" href="glib-utilities.html" title="GLib Utilities"><link rel="chapter" href="glib-data-types.html" title="GLib Data Types"><link rel="chapter" href="tools.html" title="GLib Tools"><link rel="index" href="ix01.html" title="Index"><link rel="index" href="ix02.html" title="Index of deprecated symbols"><link rel="index" href="ix03.html" title="Index of new symbols in 2.2"><link rel="index" href="ix04.html" title="Index of new symbols in 2.4"><link rel="index" href="ix05.html" title="Index of new symbols in 2.6"><link rel="index" href="ix06.html" title="Index of new symbols in 2.8"><link rel="index" href="ix07.html" title="Index of new symbols in 2.10"><link rel="index" href="ix08.html" title="Index of new symbols in 2.12"><link rel="index" href="ix09.html" title="Index of new symbols in 2.14"><link rel="index" href="ix10.html" title="Index of new symbols in 2.16"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="glib-Random-Numbers.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="glib-utilities.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">GLib Reference Manual</th><td><a accesskey="n" href="glib-Miscellaneous-Utility-Functions.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr><tr><td colspan="5" class="shortcuts"><nobr><a href="#id3055166" class="shortcut">Top</a>  |  <a href="#id3056278" class="shortcut">Description</a></nobr></td></tr></table><div class="refentry" lang="en"><a name="glib-Hook-Functions"></a><div class="titlepage"></div><div class="refnamediv"><table width="100%"><tr><td valign="top"><h2><a name="id3055166"></a><span class="refentrytitle">Hook Functions</span></h2><p>Hook Functions — support for manipulating lists of hook functions</p></td><td valign="top" align="right"></td></tr></table></div><div class="refsynopsisdiv"><h2>Synopsis</h2><pre class="synopsis">#include <glib.h> <a class="link" href="glib-Hook-Functions.html#GHookList">GHookList</a>;void (<a class="link" href="glib-Hook-Functions.html#GHookFinalizeFunc">*GHookFinalizeFunc</a>) (<a class="link" href="glib-Hook-Functions.html#GHookList">GHookList</a> *hook_list, <a class="link" href="glib-Hook-Functions.html#GHook">GHook</a> *hook); <a class="link" href="glib-Hook-Functions.html#GHook">GHook</a>;void (<a class="link" href="glib-Hook-Functions.html#GHookFunc">*GHookFunc</a>) (<a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> data);<a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> (<a class="link" href="glib-Hook-Functions.html#GHookCheckFunc">*GHookCheckFunc</a>) (<a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> data);void <a class="link" href="glib-Hook-Functions.html#g-hook-list-init">g_hook_list_init</a> (<a class="link" href="glib-Hook-Functions.html#GHookList">GHookList</a> *hook_list, <a class="link" href="glib-Basic-Types.html#guint">guint</a> hook_size);void <a class="link" href="glib-Hook-Functions.html#g-hook-list-invoke">g_hook_list_invoke</a> (<a class="link" href="glib-Hook-Functions.html#GHookList">GHookList</a> *hook_list, <a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> may_recurse);void <a class="link" href="glib-Hook-Functions.html#g-hook-list-invoke-check">g_hook_list_invoke_check</a> (<a class="link" href="glib-Hook-Functions.html#GHookList">GHookList</a> *hook_list, <a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> may_recurse);void <a class="link" href="glib-Hook-Functions.html#g-hook-list-marshal">g_hook_list_marshal</a> (<a class="link" href="glib-Hook-Functions.html#GHookList">GHookList</a> *hook_list, <a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> may_recurse, <a class="link" href="glib-Hook-Functions.html#GHookMarshaller">GHookMarshaller</a> marshaller, <a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> marshal_data);void (<a class="link" href="glib-Hook-Functions.html#GHookMarshaller">*GHookMarshaller</a>) (<a class="link" href="glib-Hook-Functions.html#GHook">GHook</a> *hook, <a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> marshal_data);void <a class="link" href="glib-Hook-Functions.html#g-hook-list-marshal-check">g_hook_list_marshal_check</a> (<a class="link" href="glib-Hook-Functions.html#GHookList">GHookList</a> *hook_list, <a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> may_recurse, <a class="link" href="glib-Hook-Functions.html#GHookCheckMarshaller">GHookCheckMarshaller</a> marshaller, <a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> marshal_data);<a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> (<a class="link" href="glib-Hook-Functions.html#GHookCheckMarshaller">*GHookCheckMarshaller</a>) (<a class="link" href="glib-Hook-Functions.html#GHook">GHook</a> *hook, <a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> marshal_data);void <a class="link" href="glib-Hook-Functions.html#g-hook-list-clear">g_hook_list_clear</a> (<a class="link" href="glib-Hook-Functions.html#GHookList">GHookList</a> *hook_list);<a class="link" href="glib-Hook-Functions.html#GHook">GHook</a>* <a class="link" href="glib-Hook-Functions.html#g-hook-alloc">g_hook_alloc</a> (<a class="link" href="glib-Hook-Functions.html#GHookList">GHookList</a> *hook_list);#define <a class="link" href="glib-Hook-Functions.html#g-hook-append">g_hook_append</a> ( hook_list, hook )void <a class="link" href="glib-Hook-Functions.html#g-hook-prepend">g_hook_prepend</a> (<a class="link" href="glib-Hook-Functions.html#GHookList">GHookList</a> *hook_list, <a class="link" href="glib-Hook-Functions.html#GHook">GHook</a> *hook);void <a class="link" href="glib-Hook-Functions.html#g-hook-insert-before">g_hook_insert_before</a> (<a class="link" href="glib-Hook-Functions.html#GHookList">GHookList</a> *hook_list, <a class="link" href="glib-Hook-Functions.html#GHook">GHook</a> *sibling, <a class="link" href="glib-Hook-Functions.html#GHook">GHook</a> *hook);void <a class="link" href="glib-Hook-Functions.html#g-hook-insert-sorted">g_hook_insert_sorted</a> (<a class="link" href="glib-Hook-Functions.html#GHookList">GHookList</a> *hook_list, <a class="link" href="glib-Hook-Functions.html#GHook">GHook</a> *hook, <a class="link" href="glib-Hook-Functions.html#GHookCompareFunc">GHookCompareFunc</a> func);<a class="link" href="glib-Basic-Types.html#gint">gint</a> (<a class="link" href="glib-Hook-Functions.html#GHookCompareFunc">*GHookCompareFunc</a>) (<a class="link" href="glib-Hook-Functions.html#GHook">GHook</a> *new_hook, <a class="link" href="glib-Hook-Functions.html#GHook">GHook</a> *sibling);<a class="link" href="glib-Basic-Types.html#gint">gint</a> <a class="link" href="glib-Hook-Functions.html#g-hook-compare-ids">g_hook_compare_ids</a> (<a class="link" href="glib-Hook-Functions.html#GHook">GHook</a> *new_hook, <a class="link" href="glib-Hook-Functions.html#GHook">GHook</a> *sibling);<a class="link" href="glib-Hook-Functions.html#GHook">GHook</a>* <a class="link" href="glib-Hook-Functions.html#g-hook-get">g_hook_get</a> (<a class="link" href="glib-Hook-Functions.html#GHookList">GHookList</a> *hook_list, <a class="link" href="glib-Basic-Types.html#gulong">gulong</a> hook_id);<a class="link" href="glib-Hook-Functions.html#GHook">GHook</a>* <a class="link" href="glib-Hook-Functions.html#g-hook-find">g_hook_find</a> (<a class="link" href="glib-Hook-Functions.html#GHookList">GHookList</a> *hook_list, <a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> need_valids, <a class="link" href="glib-Hook-Functions.html#GHookFindFunc">GHookFindFunc</a> func, <a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> data);<a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> (<a class="link" href="glib-Hook-Functions.html#GHookFindFunc">*GHookFindFunc</a>) (<a class="link" href="glib-Hook-Functions.html#GHook">GHook</a> *hook, <a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> data);<a class="link" href="glib-Hook-Functions.html#GHook">GHook</a>* <a class="link" href="glib-Hook-Functions.html#g-hook-find-data">g_hook_find_data</a> (<a class="link" href="glib-Hook-Functions.html#GHookList">GHookList</a> *hook_list, <a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> need_valids, <a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> data);<a class="link" href="glib-Hook-Functions.html#GHook">GHook</a>* <a class="link" href="glib-Hook-Functions.html#g-hook-find-func">g_hook_find_func</a> (<a class="link" href="glib-Hook-Functions.html#GHookList">GHookList</a> *hook_list, <a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> need_valids, <a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> func);<a class="link" href="glib-Hook-Functions.html#GHook">GHook</a>* <a class="link" href="glib-Hook-Functions.html#g-hook-find-func-data">g_hook_find_func_data</a> (<a class="link" href="glib-Hook-Functions.html#GHookList">GHookList</a> *hook_list, <a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> need_valids, <a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> func, <a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> data);<a class="link" href="glib-Hook-Functions.html#GHook">GHook</a>* <a class="link" href="glib-Hook-Functions.html#g-hook-first-valid">g_hook_first_valid</a> (<a class="link" href="glib-Hook-Functions.html#GHookList">GHookList</a> *hook_list, <a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> may_be_in_call);<a class="link" href="glib-Hook-Functions.html#GHook">GHook</a>* <a class="link" href="glib-Hook-Functions.html#g-hook-next-valid">g_hook_next_valid</a> (<a class="link" href="glib-Hook-Functions.html#GHookList">GHookList</a> *hook_list, <a class="link" href="glib-Hook-Functions.html#GHook">GHook</a> *hook, <a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> may_be_in_call);enum <a class="link" href="glib-Hook-Functions.html#GHookFlagMask">GHookFlagMask</a>;#define <a class="link" href="glib-Hook-Functions.html#G-HOOK-FLAGS:CAPS">G_HOOK_FLAGS</a> (hook)#define <a class="link" href="glib-Hook-Functions.html#G-HOOK-FLAG-USER-SHIFT:CAPS">G_HOOK_FLAG_USER_SHIFT</a>#define <a class="link" href="glib-Hook-Functions.html#G-HOOK:CAPS">G_HOOK</a> (hook)#define <a class="link" href="glib-Hook-Functions.html#G-HOOK-IS-VALID:CAPS">G_HOOK_IS_VALID</a> (hook)#define <a class="link" href="glib-Hook-Functions.html#G-HOOK-ACTIVE:CAPS">G_HOOK_ACTIVE</a> (hook)#define <a class="link" href="glib-Hook-Functions.html#G-HOOK-IN-CALL:CAPS">G_HOOK_IN_CALL</a> (hook)#define <a class="link" href="glib-Hook-Functions.html#G-HOOK-IS-UNLINKED:CAPS">G_HOOK_IS_UNLINKED</a> (hook)<a class="link" href="glib-Hook-Functions.html#GHook">GHook</a>* <a class="link" href="glib-Hook-Functions.html#g-hook-ref">g_hook_ref</a> (<a class="link" href="glib-Hook-Functions.html#GHookList">GHookList</a> *hook_list, <a class="link" href="glib-Hook-Functions.html#GHook">GHook</a> *hook);void <a class="link" href="glib-Hook-Functions.html#g-hook-unref">g_hook_unref</a> (<a class="link" href="glib-Hook-Functions.html#GHookList">GHookList</a> *hook_list, <a class="link" href="glib-Hook-Functions.html#GHook">GHook</a> *hook);void <a class="link" href="glib-Hook-Functions.html#g-hook-free">g_hook_free</a> (<a class="link" href="glib-Hook-Functions.html#GHookList">GHookList</a> *hook_list, <a class="link" href="glib-Hook-Functions.html#GHook">GHook</a> *hook);<a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="glib-Hook-Functions.html#g-hook-destroy">g_hook_destroy</a> (<a class="link" href="glib-Hook-Functions.html#GHookList">GHookList</a> *hook_list, <a class="link" href="glib-Basic-Types.html#gulong">gulong</a> hook_id);void <a class="link" href="glib-Hook-Functions.html#g-hook-destroy-link">g_hook_destroy_link</a> (<a class="link" href="glib-Hook-Functions.html#GHookList">GHookList</a> *hook_list, <a class="link" href="glib-Hook-Functions.html#GHook">GHook</a> *hook);</pre></div><div class="refsect1" lang="en"><a name="id3056278"></a><h2>Description</h2><p>The <a class="link" href="glib-Hook-Functions.html#GHookList"><span class="type">GHookList</span></a>, <a class="link" href="glib-Hook-Functions.html#GHook"><span class="type">GHook</span></a> and their related functions provide support forlists of hook functions. Functions can be added and removed from the lists,and the list of hook functions can be invoked.</p></div><div class="refsect1" lang="en"><a name="id3056311"></a><h2>Details</h2><div class="refsect2" lang="en"><a name="id3056321"></a><h3><a name="GHookList"></a>GHookList</h3><a class="indexterm" name="id3056334"></a><pre class="programlisting">typedef struct { gulong seq_id; guint hook_size : 16; guint is_setup : 1; GHook *hooks; gpointer dummy3; GHookFinalizeFunc finalize_hook; gpointer dummy[2];} GHookList;</pre><p>The <span class="structname">GHookList</span> struct represents a list of hook functions.</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><p><span class="term"><a class="link" href="glib-Basic-Types.html#gulong">gulong</a> <em class="structfield"><code>seq_id</code></em>;</span></p></td><td>the next free <a class="link" href="glib-Hook-Functions.html#GHook"><span class="type">GHook</span></a> id</td></tr><tr><td><p><span class="term"><a class="link" href="glib-Basic-Types.html#guint">guint</a> <em class="structfield"><code>hook_size</code></em> : 16;</span></p></td><td>the size of the <a class="link" href="glib-Hook-Functions.html#GHookList"><span class="type">GHookList</span></a> elements, in bytes</td></tr><tr><td><p><span class="term"><a class="link" href="glib-Basic-Types.html#guint">guint</a> <em class="structfield"><code>is_setup</code></em> : 1;</span></p></td><td>1 if the <a class="link" href="glib-Hook-Functions.html#GHookList"><span class="type">GHookList</span></a> has been initialized</td></tr><tr><td><p><span class="term"><a class="link" href="glib-Hook-Functions.html#GHook">GHook</a> *<em class="structfield"><code>hooks</code></em>;</span></p></td><td>the first <a class="link" href="glib-Hook-Functions.html#GHook"><span class="type">GHook</span></a> element in the list</td></tr><tr><td><p><span class="term"><a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> <em class="structfield"><code>dummy3</code></em>;</span></p></td><td>unused</td></tr><tr><td><p><span class="term"><a class="link" href="glib-Hook-Functions.html#GHookFinalizeFunc">GHookFinalizeFunc</a> <em class="structfield"><code>finalize_hook</code></em>;</span></p></td><td>the function to call to finalize a <a class="link" href="glib-Hook-Functions.html#GHook"><span class="type">GHook</span></a> element. Thedefault behaviour is to call the hooks <code class="function">destroy</code> function</td></tr><tr><td><p><span class="term"><a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> <em class="structfield"><code>dummy</code></em>[2];</span></p></td><td>unused</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id3056552"></a><h3><a name="GHookFinalizeFunc"></a>GHookFinalizeFunc ()</h3>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -