1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5 <title>GICallableInfo</title>
6 <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
7 <link rel="home" href="index.html" title="GObject Introspection Reference Manual">
8 <link rel="up" href="gi-repository-structs.html" title="GIRepository structs">
9 <link rel="prev" href="gi-GIFunctionInfo.html" title="GIFunctionInfo">
10 <link rel="next" href="gi-GIArgInfo.html" title="GIArgInfo">
11 <meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
12 <link rel="stylesheet" href="style.css" type="text/css">
14 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
17 <td><a accesskey="p" href="gi-GIFunctionInfo.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18 <td><a accesskey="u" href="gi-repository-structs.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
19 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
20 <th width="100%" align="center">GObject Introspection Reference Manual</th>
21 <td><a accesskey="n" href="gi-GIArgInfo.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
23 <tr><td colspan="5" class="shortcuts">
24 <a href="#gi-GICallableInfo.synopsis" class="shortcut">Top</a>
26 <a href="#gi-GICallableInfo.description" class="shortcut">Description</a>
29 <div class="refentry">
30 <a name="gi-GICallableInfo"></a><div class="titlepage"></div>
31 <div class="refnamediv"><table width="100%"><tr>
33 <h2><span class="refentrytitle"><a name="gi-GICallableInfo.top_of_page"></a>GICallableInfo</span></h2>
34 <p>GICallableInfo — Struct representing a callable</p>
36 <td valign="top" align="right"></td>
38 <div class="refsynopsisdiv">
39 <a name="gi-GICallableInfo.synopsis"></a><h2>Synopsis</h2>
40 <pre class="synopsis">#define <a class="link" href="gi-GICallableInfo.html#GI-IS-CALLABLE-INFO:CAPS" title="GI_IS_CALLABLE_INFO()">GI_IS_CALLABLE_INFO</a> (info)
41 typedef <a class="link" href="gi-GICallableInfo.html#GICallableInfo" title="GICallableInfo">GICallableInfo</a>;
42 <a class="link" href="gi-GITypeInfo.html#GITypeInfo" title="GITypeInfo"><span class="returnvalue">GITypeInfo</span></a> * <a class="link" href="gi-GICallableInfo.html#g-callable-info-get-return-type" title="g_callable_info_get_return_type ()">g_callable_info_get_return_type</a> (<em class="parameter"><code><a class="link" href="gi-GICallableInfo.html#GICallableInfo" title="GICallableInfo"><span class="type">GICallableInfo</span></a> *info</code></em>);
43 <a class="link" href="gi-GIArgInfo.html#GITransfer" title="enum GITransfer"><span class="returnvalue">GITransfer</span></a> <a class="link" href="gi-GICallableInfo.html#g-callable-info-get-caller-owns" title="g_callable_info_get_caller_owns ()">g_callable_info_get_caller_owns</a> (<em class="parameter"><code><a class="link" href="gi-GICallableInfo.html#GICallableInfo" title="GICallableInfo"><span class="type">GICallableInfo</span></a> *info</code></em>);
44 <span class="returnvalue">gboolean</span> <a class="link" href="gi-GICallableInfo.html#g-callable-info-may-return-null" title="g_callable_info_may_return_null ()">g_callable_info_may_return_null</a> (<em class="parameter"><code><a class="link" href="gi-GICallableInfo.html#GICallableInfo" title="GICallableInfo"><span class="type">GICallableInfo</span></a> *info</code></em>);
45 const <span class="returnvalue">gchar</span> * <a class="link" href="gi-GICallableInfo.html#g-callable-info-get-return-attribute" title="g_callable_info_get_return_attribute ()">g_callable_info_get_return_attribute</a>
46 (<em class="parameter"><code><a class="link" href="gi-GICallableInfo.html#GICallableInfo" title="GICallableInfo"><span class="type">GICallableInfo</span></a> *info</code></em>,
47 <em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>);
48 <span class="returnvalue">gboolean</span> <a class="link" href="gi-GICallableInfo.html#g-callable-info-iterate-return-attributes" title="g_callable_info_iterate_return_attributes ()">g_callable_info_iterate_return_attributes</a>
49 (<em class="parameter"><code><a class="link" href="gi-GICallableInfo.html#GICallableInfo" title="GICallableInfo"><span class="type">GICallableInfo</span></a> *info</code></em>,
50 <em class="parameter"><code><a class="link" href="gi-GIBaseInfo.html#GIAttributeIter" title="GIAttributeIter"><span class="type">GIAttributeIter</span></a> *iterator</code></em>,
51 <em class="parameter"><code><span class="type">char</span> **name</code></em>,
52 <em class="parameter"><code><span class="type">char</span> **value</code></em>);
53 <span class="returnvalue">gint</span> <a class="link" href="gi-GICallableInfo.html#g-callable-info-get-n-args" title="g_callable_info_get_n_args ()">g_callable_info_get_n_args</a> (<em class="parameter"><code><a class="link" href="gi-GICallableInfo.html#GICallableInfo" title="GICallableInfo"><span class="type">GICallableInfo</span></a> *info</code></em>);
54 <a class="link" href="gi-GIArgInfo.html#GIArgInfo" title="GIArgInfo"><span class="returnvalue">GIArgInfo</span></a> * <a class="link" href="gi-GICallableInfo.html#g-callable-info-get-arg" title="g_callable_info_get_arg ()">g_callable_info_get_arg</a> (<em class="parameter"><code><a class="link" href="gi-GICallableInfo.html#GICallableInfo" title="GICallableInfo"><span class="type">GICallableInfo</span></a> *info</code></em>,
55 <em class="parameter"><code><span class="type">gint</span> n</code></em>);
56 <span class="returnvalue">void</span> <a class="link" href="gi-GICallableInfo.html#g-callable-info-load-arg" title="g_callable_info_load_arg ()">g_callable_info_load_arg</a> (<em class="parameter"><code><a class="link" href="gi-GICallableInfo.html#GICallableInfo" title="GICallableInfo"><span class="type">GICallableInfo</span></a> *info</code></em>,
57 <em class="parameter"><code><span class="type">gint</span> n</code></em>,
58 <em class="parameter"><code><a class="link" href="gi-GIArgInfo.html#GIArgInfo" title="GIArgInfo"><span class="type">GIArgInfo</span></a> *arg</code></em>);
59 <span class="returnvalue">void</span> <a class="link" href="gi-GICallableInfo.html#g-callable-info-load-return-type" title="g_callable_info_load_return_type ()">g_callable_info_load_return_type</a> (<em class="parameter"><code><a class="link" href="gi-GICallableInfo.html#GICallableInfo" title="GICallableInfo"><span class="type">GICallableInfo</span></a> *info</code></em>,
60 <em class="parameter"><code><a class="link" href="gi-GITypeInfo.html#GITypeInfo" title="GITypeInfo"><span class="type">GITypeInfo</span></a> *type</code></em>);
63 <div class="refsect1">
64 <a name="gi-GICallableInfo.description"></a><h2>Description</h2>
66 GICallableInfo represents an entity which is callable.
67 Currently a function (<a class="link" href="gi-GIFunctionInfo.html#GIFunctionInfo" title="GIFunctionInfo"><span class="type">GIFunctionInfo</span></a>), virtual function,
68 (<a class="link" href="gi-GIVFuncInfo.html#GIVFuncInfo" title="GIVFuncInfo"><span class="type">GIVFuncInfo</span></a>) or callback (<a class="link" href="gi-girepository.html#GICallbackInfo" title="GICallbackInfo"><span class="type">GICallbackInfo</span></a>).
71 A callable has a list of arguments (<a class="link" href="gi-GIArgInfo.html#GIArgInfo" title="GIArgInfo"><span class="type">GIArgInfo</span></a>), a return type,
72 direction and a flag which decides if it returns null.
76 <div class="refsect1">
77 <a name="gi-gicallableinfo.struct-hierarchy"></a><h2>Struct hierarchy</h2>
78 <pre class="synopsis">
79 <a class="link" href="gi-GIBaseInfo.html" title="GIBaseInfo">GIBaseInfo</a>
81 +----<a class="link" href="gi-GIFunctionInfo.html" title="GIFunctionInfo">GIFunctionInfo</a>
82 +----<a class="link" href="gi-GISignalInfo.html" title="GISignalInfo">GISignalInfo</a>
83 +----<a class="link" href="gi-GIVFuncInfo.html" title="GIVFuncInfo">GIVFuncInfo</a>
89 <div class="refsect1">
90 <a name="gi-GICallableInfo.details"></a><h2>Details</h2>
91 <div class="refsect2">
92 <a name="GI-IS-CALLABLE-INFO:CAPS"></a><h3>GI_IS_CALLABLE_INFO()</h3>
93 <pre class="programlisting">#define GI_IS_CALLABLE_INFO(info)</pre>
96 <div class="refsect2">
97 <a name="GICallableInfo"></a><h3>GICallableInfo</h3>
98 <pre class="programlisting">typedef GIBaseInfo GICallableInfo;
101 Represents a callable, either <a class="link" href="gi-GIFunctionInfo.html#GIFunctionInfo" title="GIFunctionInfo"><span class="type">GIFunctionInfo</span></a>, <a class="link" href="gi-girepository.html#GICallbackInfo" title="GICallbackInfo"><span class="type">GICallbackInfo</span></a> or
102 <a class="link" href="gi-GIVFuncInfo.html#GIVFuncInfo" title="GIVFuncInfo"><span class="type">GIVFuncInfo</span></a>.
106 <div class="refsect2">
107 <a name="g-callable-info-get-return-type"></a><h3>g_callable_info_get_return_type ()</h3>
108 <pre class="programlisting"><a class="link" href="gi-GITypeInfo.html#GITypeInfo" title="GITypeInfo"><span class="returnvalue">GITypeInfo</span></a> * g_callable_info_get_return_type (<em class="parameter"><code><a class="link" href="gi-GICallableInfo.html#GICallableInfo" title="GICallableInfo"><span class="type">GICallableInfo</span></a> *info</code></em>);</pre>
110 Obtain the return type of a callable item as a <a class="link" href="gi-GITypeInfo.html#GITypeInfo" title="GITypeInfo"><span class="type">GITypeInfo</span></a>.
112 <div class="variablelist"><table border="0">
113 <col align="left" valign="top">
116 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
117 <td>a <a class="link" href="gi-GICallableInfo.html#GICallableInfo" title="GICallableInfo"><span class="type">GICallableInfo</span></a>
121 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
122 <td>the <a class="link" href="gi-GITypeInfo.html#GITypeInfo" title="GITypeInfo"><span class="type">GITypeInfo</span></a>. Free the struct by calling
123 <a class="link" href="gi-GIBaseInfo.html#g-base-info-unref" title="g_base_info_unref ()"><code class="function">g_base_info_unref()</code></a> when done. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
130 <div class="refsect2">
131 <a name="g-callable-info-get-caller-owns"></a><h3>g_callable_info_get_caller_owns ()</h3>
132 <pre class="programlisting"><a class="link" href="gi-GIArgInfo.html#GITransfer" title="enum GITransfer"><span class="returnvalue">GITransfer</span></a> g_callable_info_get_caller_owns (<em class="parameter"><code><a class="link" href="gi-GICallableInfo.html#GICallableInfo" title="GICallableInfo"><span class="type">GICallableInfo</span></a> *info</code></em>);</pre>
134 See whether the caller owns the return value of this callable.
135 <a class="link" href="gi-GIArgInfo.html#GITransfer" title="enum GITransfer"><span class="type">GITransfer</span></a> contains a list of possible transfer values.
137 <div class="variablelist"><table border="0">
138 <col align="left" valign="top">
141 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
142 <td>a <a class="link" href="gi-GICallableInfo.html#GICallableInfo" title="GICallableInfo"><span class="type">GICallableInfo</span></a>
146 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
148 <code class="literal">TRUE</code> if the caller owns the return value, <code class="literal">FALSE</code> otherwise.</td>
154 <div class="refsect2">
155 <a name="g-callable-info-may-return-null"></a><h3>g_callable_info_may_return_null ()</h3>
156 <pre class="programlisting"><span class="returnvalue">gboolean</span> g_callable_info_may_return_null (<em class="parameter"><code><a class="link" href="gi-GICallableInfo.html#GICallableInfo" title="GICallableInfo"><span class="type">GICallableInfo</span></a> *info</code></em>);</pre>
158 See if a callable could return <a href="/src/build/jhbuild/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>.
160 <div class="variablelist"><table border="0">
161 <col align="left" valign="top">
164 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
165 <td>a <a class="link" href="gi-GICallableInfo.html#GICallableInfo" title="GICallableInfo"><span class="type">GICallableInfo</span></a>
169 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
171 <code class="literal">TRUE</code> if callable could return <a href="/src/build/jhbuild/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>
178 <div class="refsect2">
179 <a name="g-callable-info-get-return-attribute"></a><h3>g_callable_info_get_return_attribute ()</h3>
180 <pre class="programlisting">const <span class="returnvalue">gchar</span> * g_callable_info_get_return_attribute
181 (<em class="parameter"><code><a class="link" href="gi-GICallableInfo.html#GICallableInfo" title="GICallableInfo"><span class="type">GICallableInfo</span></a> *info</code></em>,
182 <em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>);</pre>
184 Retrieve an arbitrary attribute associated with the return value.
186 <div class="variablelist"><table border="0">
187 <col align="left" valign="top">
190 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
191 <td>a <a class="link" href="gi-GICallableInfo.html#GICallableInfo" title="GICallableInfo"><span class="type">GICallableInfo</span></a>
195 <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
196 <td>a freeform string naming an attribute</td>
199 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
200 <td>The value of the attribute, or <a href="/src/build/jhbuild/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> if no such attribute exists</td>
206 <div class="refsect2">
207 <a name="g-callable-info-iterate-return-attributes"></a><h3>g_callable_info_iterate_return_attributes ()</h3>
208 <pre class="programlisting"><span class="returnvalue">gboolean</span> g_callable_info_iterate_return_attributes
209 (<em class="parameter"><code><a class="link" href="gi-GICallableInfo.html#GICallableInfo" title="GICallableInfo"><span class="type">GICallableInfo</span></a> *info</code></em>,
210 <em class="parameter"><code><a class="link" href="gi-GIBaseInfo.html#GIAttributeIter" title="GIAttributeIter"><span class="type">GIAttributeIter</span></a> *iterator</code></em>,
211 <em class="parameter"><code><span class="type">char</span> **name</code></em>,
212 <em class="parameter"><code><span class="type">char</span> **value</code></em>);</pre>
214 Iterate over all attributes associated with the return value. The
215 iterator structure is typically stack allocated, and must have its
216 first member initialized to <a href="/src/build/jhbuild/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>.
219 Both the <em class="parameter"><code>name</code></em> and <em class="parameter"><code>value</code></em> should be treated as constants
220 and must not be freed.
223 See <a class="link" href="gi-GIBaseInfo.html#g-base-info-iterate-attributes" title="g_base_info_iterate_attributes ()"><code class="function">g_base_info_iterate_attributes()</code></a> for an example of how to use a
226 <div class="variablelist"><table border="0">
227 <col align="left" valign="top">
230 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
231 <td>a <a class="link" href="gi-GICallableInfo.html#GICallableInfo" title="GICallableInfo"><span class="type">GICallableInfo</span></a>
235 <td><p><span class="term"><em class="parameter"><code>iterator</code></em> :</span></p></td>
236 <td>a <a class="link" href="gi-GIBaseInfo.html#GIAttributeIter" title="GIAttributeIter"><span class="type">GIAttributeIter</span></a> structure, must be initialized; see below</td>
239 <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
240 <td>Returned name, must not be freed. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
244 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
245 <td>Returned name, must not be freed. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
249 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
251 <code class="literal">TRUE</code> if there are more attributes</td>
257 <div class="refsect2">
258 <a name="g-callable-info-get-n-args"></a><h3>g_callable_info_get_n_args ()</h3>
259 <pre class="programlisting"><span class="returnvalue">gint</span> g_callable_info_get_n_args (<em class="parameter"><code><a class="link" href="gi-GICallableInfo.html#GICallableInfo" title="GICallableInfo"><span class="type">GICallableInfo</span></a> *info</code></em>);</pre>
261 Obtain the number of arguments (both IN and OUT) for this callable.
263 <div class="variablelist"><table border="0">
264 <col align="left" valign="top">
267 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
268 <td>a <a class="link" href="gi-GICallableInfo.html#GICallableInfo" title="GICallableInfo"><span class="type">GICallableInfo</span></a>
272 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
273 <td>The number of arguments this callable expects.</td>
279 <div class="refsect2">
280 <a name="g-callable-info-get-arg"></a><h3>g_callable_info_get_arg ()</h3>
281 <pre class="programlisting"><a class="link" href="gi-GIArgInfo.html#GIArgInfo" title="GIArgInfo"><span class="returnvalue">GIArgInfo</span></a> * g_callable_info_get_arg (<em class="parameter"><code><a class="link" href="gi-GICallableInfo.html#GICallableInfo" title="GICallableInfo"><span class="type">GICallableInfo</span></a> *info</code></em>,
282 <em class="parameter"><code><span class="type">gint</span> n</code></em>);</pre>
284 Obtain information about a particular argument of this callable.
286 <div class="variablelist"><table border="0">
287 <col align="left" valign="top">
290 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
291 <td>a <a class="link" href="gi-GICallableInfo.html#GICallableInfo" title="GICallableInfo"><span class="type">GICallableInfo</span></a>
295 <td><p><span class="term"><em class="parameter"><code>n</code></em> :</span></p></td>
296 <td>the argument index to fetch</td>
299 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
300 <td>the <a class="link" href="gi-GIArgInfo.html#GIArgInfo" title="GIArgInfo"><span class="type">GIArgInfo</span></a>. Free it with
301 <a class="link" href="gi-GIBaseInfo.html#g-base-info-unref" title="g_base_info_unref ()"><code class="function">g_base_info_unref()</code></a> when done. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
308 <div class="refsect2">
309 <a name="g-callable-info-load-arg"></a><h3>g_callable_info_load_arg ()</h3>
310 <pre class="programlisting"><span class="returnvalue">void</span> g_callable_info_load_arg (<em class="parameter"><code><a class="link" href="gi-GICallableInfo.html#GICallableInfo" title="GICallableInfo"><span class="type">GICallableInfo</span></a> *info</code></em>,
311 <em class="parameter"><code><span class="type">gint</span> n</code></em>,
312 <em class="parameter"><code><a class="link" href="gi-GIArgInfo.html#GIArgInfo" title="GIArgInfo"><span class="type">GIArgInfo</span></a> *arg</code></em>);</pre>
314 Obtain information about a particular argument of this callable; this
315 function is a variant of <a class="link" href="gi-GICallableInfo.html#g-callable-info-get-arg" title="g_callable_info_get_arg ()"><code class="function">g_callable_info_get_arg()</code></a> designed for stack
319 The initialized <em class="parameter"><code>arg</code></em> must not be referenced after <em class="parameter"><code>info</code></em> is deallocated.
321 <div class="variablelist"><table border="0">
322 <col align="left" valign="top">
325 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
326 <td>a <a class="link" href="gi-GICallableInfo.html#GICallableInfo" title="GICallableInfo"><span class="type">GICallableInfo</span></a>
330 <td><p><span class="term"><em class="parameter"><code>n</code></em> :</span></p></td>
331 <td>the argument index to fetch</td>
334 <td><p><span class="term"><em class="parameter"><code>arg</code></em> :</span></p></td>
335 <td>Initialize with argument number <em class="parameter"><code>n</code></em>. <span class="annotation">[<acronym title="Out parameter, where caller must allocate storage."><span class="acronym">out caller-allocates</span></acronym>]</span>
342 <div class="refsect2">
343 <a name="g-callable-info-load-return-type"></a><h3>g_callable_info_load_return_type ()</h3>
344 <pre class="programlisting"><span class="returnvalue">void</span> g_callable_info_load_return_type (<em class="parameter"><code><a class="link" href="gi-GICallableInfo.html#GICallableInfo" title="GICallableInfo"><span class="type">GICallableInfo</span></a> *info</code></em>,
345 <em class="parameter"><code><a class="link" href="gi-GITypeInfo.html#GITypeInfo" title="GITypeInfo"><span class="type">GITypeInfo</span></a> *type</code></em>);</pre>
347 Obtain information about a return value of callable; this
348 function is a variant of <a class="link" href="gi-GICallableInfo.html#g-callable-info-get-return-type" title="g_callable_info_get_return_type ()"><code class="function">g_callable_info_get_return_type()</code></a> designed for stack
352 The initialized <em class="parameter"><code>type</code></em> must not be referenced after <em class="parameter"><code>info</code></em> is deallocated.
354 <div class="variablelist"><table border="0">
355 <col align="left" valign="top">
358 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
359 <td>a <a class="link" href="gi-GICallableInfo.html#GICallableInfo" title="GICallableInfo"><span class="type">GICallableInfo</span></a>
363 <td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
364 <td>Initialized with return type of <em class="parameter"><code>info</code></em>. <span class="annotation">[<acronym title="Out parameter, where caller must allocate storage."><span class="acronym">out caller-allocates</span></acronym>]</span>
374 Generated by GTK-Doc V1.18.1</div>