← Back to branch summary

~ubuntu-branches/ubuntu/trusty/gobject-introspection/trusty

« back to all changes in this revision

Viewing changes to docs/reference/html/gi-GIBaseInfo.html

  • Committer: Bazaar Package Importer
  • Author(s): Emilio Pozuelo Monfort
  • Date: 2011-03-22 00:32:36 UTC
  • mfrom: (1.4.1 upstream) (3.3.33 multiarch)
  • Revision ID: james.westby@ubuntu.com-20110322003236-4spdgfk1vai6xay1
Tags: 0.10.4-2
Upload to unstable.

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/html/gi-GIBaseInfo.html
8
8
<link rel="up" href="gi-repository-structs.html" title="GIRepository structs">
9
9
<link rel="prev" href="gi-struct-hierarchy.html" title="Struct hierarchy">
10
10
<link rel="next" href="gi-GIFunctionInfo.html" title="GIFunctionInfo">
11
 
<meta name="generator" content="GTK-Doc V1.14 (XML mode)">
 
11
<meta name="generator" content="GTK-Doc V1.16.1 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
</head>
14
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
26
26
                  <a href="#gi-GIBaseInfo.description" class="shortcut">Description</a>
27
27
</td></tr>
28
28
</table>
29
 
<div class="refentry" title="GIBaseInfo">
 
29
<div class="refentry">
30
30
<a name="gi-GIBaseInfo"></a><div class="titlepage"></div>
31
31
<div class="refnamediv"><table width="100%"><tr>
32
32
<td valign="top">
33
33
<h2><span class="refentrytitle"><a name="gi-GIBaseInfo.top_of_page"></a>GIBaseInfo</span></h2>
34
 
<p>GIBaseInfo — Base struct for all GTypelib structs</p>
 
34
<p>GIBaseInfo — Base struct for all GITypelib structs</p>
35
35
</td>
36
36
<td valign="top" align="right"></td>
37
37
</tr></table></div>
38
 
<div class="refsynopsisdiv" title="Synopsis">
 
38
<div class="refsynopsisdiv">
39
39
<a name="gi-GIBaseInfo.synopsis"></a><h2>Synopsis</h2>
40
40
<pre class="synopsis">enum                <a class="link" href="gi-GIBaseInfo.html#GIInfoType" title="enum GIInfoType">GIInfoType</a>;
 
41
const <span class="returnvalue">gchar</span> *            <a class="link" href="gi-GIBaseInfo.html#g-info-type-to-string" title="g_info_type_to_string ()">g_info_type_to_string</a>          (<em class="parameter"><code><a class="link" href="gi-GIBaseInfo.html#GIInfoType" title="enum GIInfoType"><span class="type">GIInfoType</span></a> type</code></em>);
41
42
                    <a class="link" href="gi-GIBaseInfo.html#GIAttributeIter" title="GIAttributeIter">GIAttributeIter</a>;
42
43
typedef             <a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo">GIBaseInfo</a>;
43
 
<a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="returnvalue">GIBaseInfo</span></a> *        <a class="link" href="gi-GIBaseInfo.html#g-base-info-ref" title="g_base_info_ref ()">g_base_info_ref</a>                     (<em class="parameter"><code><a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="type">GIBaseInfo</span></a> *info</code></em>);
 
44
<a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="returnvalue">GIBaseInfo</span></a> *            <a class="link" href="gi-GIBaseInfo.html#g-base-info-ref" title="g_base_info_ref ()">g_base_info_ref</a>                 (<em class="parameter"><code><a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="type">GIBaseInfo</span></a> *info</code></em>);
44
45
<span class="returnvalue">void</span>                <a class="link" href="gi-GIBaseInfo.html#g-base-info-unref" title="g_base_info_unref ()">g_base_info_unref</a>                   (<em class="parameter"><code><a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="type">GIBaseInfo</span></a> *info</code></em>);
45
46
<a class="link" href="gi-GIBaseInfo.html#GIInfoType" title="enum GIInfoType"><span class="returnvalue">GIInfoType</span></a>          <a class="link" href="gi-GIBaseInfo.html#g-base-info-get-type" title="g_base_info_get_type ()">g_base_info_get_type</a>                (<em class="parameter"><code><a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="type">GIBaseInfo</span></a> *info</code></em>);
46
 
const <span class="returnvalue">gchar</span> *       <a class="link" href="gi-GIBaseInfo.html#g-base-info-get-name" title="g_base_info_get_name ()">g_base_info_get_name</a>                (<em class="parameter"><code><a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="type">GIBaseInfo</span></a> *info</code></em>);
47
 
const <span class="returnvalue">gchar</span> *       <a class="link" href="gi-GIBaseInfo.html#g-base-info-get-namespace" title="g_base_info_get_namespace ()">g_base_info_get_namespace</a>           (<em class="parameter"><code><a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="type">GIBaseInfo</span></a> *info</code></em>);
 
47
const <span class="returnvalue">gchar</span> *           <a class="link" href="gi-GIBaseInfo.html#g-base-info-get-name" title="g_base_info_get_name ()">g_base_info_get_name</a>            (<em class="parameter"><code><a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="type">GIBaseInfo</span></a> *info</code></em>);
 
48
const <span class="returnvalue">gchar</span> *           <a class="link" href="gi-GIBaseInfo.html#g-base-info-get-namespace" title="g_base_info_get_namespace ()">g_base_info_get_namespace</a>       (<em class="parameter"><code><a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="type">GIBaseInfo</span></a> *info</code></em>);
48
49
<span class="returnvalue">gboolean</span>            <a class="link" href="gi-GIBaseInfo.html#g-base-info-is-deprecated" title="g_base_info_is_deprecated ()">g_base_info_is_deprecated</a>           (<em class="parameter"><code><a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="type">GIBaseInfo</span></a> *info</code></em>);
49
 
const <span class="returnvalue">gchar</span> *       <a class="link" href="gi-GIBaseInfo.html#g-base-info-get-attribute" title="g_base_info_get_attribute ()">g_base_info_get_attribute</a>           (<em class="parameter"><code><a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="type">GIBaseInfo</span></a> *info</code></em>,
 
50
const <span class="returnvalue">gchar</span> *           <a class="link" href="gi-GIBaseInfo.html#g-base-info-get-attribute" title="g_base_info_get_attribute ()">g_base_info_get_attribute</a>       (<em class="parameter"><code><a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="type">GIBaseInfo</span></a> *info</code></em>,
50
51
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>);
51
52
<span class="returnvalue">gboolean</span>            <a class="link" href="gi-GIBaseInfo.html#g-base-info-iterate-attributes" title="g_base_info_iterate_attributes ()">g_base_info_iterate_attributes</a>      (<em class="parameter"><code><a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="type">GIBaseInfo</span></a> *info</code></em>,
52
53
                                                         <em class="parameter"><code><a class="link" href="gi-GIBaseInfo.html#GIAttributeIter" title="GIAttributeIter"><span class="type">GIAttributeIter</span></a> *iterator</code></em>,
53
54
                                                         <em class="parameter"><code><span class="type">char</span> **name</code></em>,
54
55
                                                         <em class="parameter"><code><span class="type">char</span> **value</code></em>);
55
 
<a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="returnvalue">GIBaseInfo</span></a> *        <a class="link" href="gi-GIBaseInfo.html#g-base-info-get-container" title="g_base_info_get_container ()">g_base_info_get_container</a>           (<em class="parameter"><code><a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="type">GIBaseInfo</span></a> *info</code></em>);
56
 
<a class="link" href="gi-girepository.html#GTypelib" title="GTypelib"><span class="returnvalue">GTypelib</span></a> *          <a class="link" href="gi-GIBaseInfo.html#g-base-info-get-typelib" title="g_base_info_get_typelib ()">g_base_info_get_typelib</a>             (<em class="parameter"><code><a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="type">GIBaseInfo</span></a> *info</code></em>);
 
56
<a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="returnvalue">GIBaseInfo</span></a> *            <a class="link" href="gi-GIBaseInfo.html#g-base-info-get-container" title="g_base_info_get_container ()">g_base_info_get_container</a>       (<em class="parameter"><code><a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="type">GIBaseInfo</span></a> *info</code></em>);
 
57
<a class="link" href="gi-girepository.html#GITypelib" title="GITypelib"><span class="returnvalue">GITypelib</span></a> *              <a class="link" href="gi-GIBaseInfo.html#g-base-info-get-typelib" title="g_base_info_get_typelib ()">g_base_info_get_typelib</a>        (<em class="parameter"><code><a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="type">GIBaseInfo</span></a> *info</code></em>);
57
58
<span class="returnvalue">gboolean</span>            <a class="link" href="gi-GIBaseInfo.html#g-base-info-equal" title="g_base_info_equal ()">g_base_info_equal</a>                   (<em class="parameter"><code><a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="type">GIBaseInfo</span></a> *info1</code></em>,
58
59
                                                         <em class="parameter"><code><a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="type">GIBaseInfo</span></a> *info2</code></em>);
59
60
</pre>
60
61
</div>
61
 
<div class="refsect1" title="Description">
 
62
<div class="refsect1">
62
63
<a name="gi-GIBaseInfo.description"></a><h2>Description</h2>
63
64
<p>
64
65
GIBaseInfo is the common base struct of all other *Info structs
66
67
All other structs can be casted to a <a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="type">GIBaseInfo</span></a>, for instance:
67
68
</p>
68
69
<div class="example">
69
 
<a name="id2826527"></a><p class="title"><b>Example 1. Casting a <a class="link" href="gi-GIFunctionInfo.html#GIFunctionInfo" title="GIFunctionInfo"><span class="type">GIFunctionInfo</span></a> to <a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="type">GIBaseInfo</span></a></b></p>
 
70
<a name="id479793"></a><p class="title"><b>Example 1. Casting a <a class="link" href="gi-GIFunctionInfo.html#GIFunctionInfo" title="GIFunctionInfo"><span class="type">GIFunctionInfo</span></a> to <a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="type">GIBaseInfo</span></a></b></p>
70
71
<div class="example-contents">
71
72
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
72
73
    <tbody>
73
74
      <tr>
74
75
        <td class="listing_lines" align="right"><pre>1
75
76
2</pre></td>
76
 
        <td class="listing_code"><pre class="programlisting"><span class="normal"><a href="gi-GIFunctionInfo.html#GIFunctionInfo">GIFunctionInfo</a> </span><span class="symbol">*</span><span class="normal">function_info </span><span class="symbol">=</span><span class="normal"> </span><span class="symbol">...;</span>
77
 
<span class="normal"><a href="gi-GIBaseInfo.html#GIBaseInfo">GIBaseInfo</a> </span><span class="symbol">*</span><span class="normal">info </span><span class="symbol">=</span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="gi-GIBaseInfo.html#GIBaseInfo">GIBaseInfo</a></span><span class="symbol">*)</span><span class="normal">function_info</span><span class="symbol">;</span></pre></td>
 
77
        <td class="listing_code"><pre class="programlisting">GIFunctionInfo *function_info = ...;
 
78
   GIBaseInfo *info = (GIBaseInfo*)function_info;</pre></td>
78
79
      </tr>
79
80
    </tbody>
80
81
  </table>
90
91
<p>
91
92
</p>
92
93
<div class="example">
93
 
<a name="id2826734"></a><p class="title"><b>Example 2. Getting the Button of the Gtk typelib</b></p>
 
94
<a name="id464298"></a><p class="title"><b>Example 2. Getting the Button of the Gtk typelib</b></p>
94
95
<div class="example-contents">
95
96
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
96
97
    <tbody>
98
99
        <td class="listing_lines" align="right"><pre>1
99
100
2
100
101
3</pre></td>
101
 
        <td class="listing_code"><pre class="programlisting"><span class="normal"><a href="gi-GIBaseInfo.html#GIBaseInfo">GIBaseInfo</a> </span><span class="symbol">*</span><span class="normal">button_info </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="gi-girepository.html#g-irepository-find-by-name">g_irepository_find_by_name</a></span><span class="symbol">(</span><span class="normal">NULL</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"Gtk"</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"Button"</span><span class="symbol">);</span>
102
 
<span class="symbol">...</span><span class="normal"> use button_info </span><span class="symbol">...</span>
103
 
<span class="function"><a href="gi-GIBaseInfo.html#g-base-info-unref">g_base_info_unref</a></span><span class="symbol">(</span><span class="normal">button_info</span><span class="symbol">);</span></pre></td>
 
102
        <td class="listing_code"><pre class="programlisting">GIBaseInfo *button_info = g_irepository_find_by_name(<span class="number">NULL</span>, <span class="number">&quot;Gtk&quot;</span>, <span class="number">&quot;Button&quot;</span>);
 
103
   ... use button_info ...
 
104
   g_base_info_unref(button_info);</pre></td>
104
105
      </tr>
105
106
    </tbody>
106
107
  </table>
109
110
</div>
110
111
<p><br class="example-break">
111
112
</p>
112
 
</div>
113
 
<div class="refsect1" title="Details">
 
113
<p>
 
114
</p>
 
115
<div class="refsect1">
 
116
<a name="gi-gibaseinfo.struct-hierarchy"></a><h2>Struct hierarchy</h2>
 
117
<pre class="synopsis">
 
118
  GIBaseInfo
 
119
   +----<a class="link" href="gi-GIArgInfo.html" title="GIArgInfo">GIArgInfo</a>
 
120
   +----<a class="link" href="gi-GICallableInfo.html" title="GICallableInfo">GICallableInfo</a>
 
121
   +----<a class="link" href="gi-GIConstantInfo.html" title="GIConstantInfo">GIConstantInfo</a>
 
122
   +----<a class="link" href="gi-GIErrorDomainInfo.html" title="GIErrorDomainInfo">GIErrorDomainInfo</a>
 
123
   +----<a class="link" href="gi-GIFieldInfo.html" title="GIFieldInfo">GIFieldInfo</a>
 
124
   +----<a class="link" href="gi-GIPropertyInfo.html" title="GIPropertyInfo">GIPropertyInfo</a>
 
125
   +----<a class="link" href="gi-GIRegisteredTypeInfo.html" title="GIRegisteredTypeInfo">GIRegisteredTypeInfo</a>
 
126
   +----<a class="link" href="gi-GITypeInfo.html" title="GITypeInfo">GITypeInfo</a>
 
127
</pre>
 
128
</div>
 
129
<p>
 
130
</p>
 
131
</div>
 
132
<div class="refsect1">
114
133
<a name="gi-GIBaseInfo.details"></a><h2>Details</h2>
115
 
<div class="refsect2" title="enum GIInfoType">
 
134
<div class="refsect2">
116
135
<a name="GIInfoType"></a><h3>enum GIInfoType</h3>
117
136
<pre class="programlisting">typedef enum
118
137
{
161
180
</tr>
162
181
<tr>
163
182
<td><p><a name="GI-INFO-TYPE-STRUCT:CAPS"></a><span class="term"><code class="literal">GI_INFO_TYPE_STRUCT</code></span></p></td>
164
 
<td>struct, see <a class="link" href="gi-gistructinfo.html#GIStructInfo" title="GIStructInfo"><span class="type">GIStructInfo</span></a>
 
183
<td>struct, see <a class="link" href="gi-GIStructInfo.html#GIStructInfo" title="GIStructInfo"><span class="type">GIStructInfo</span></a>
165
184
</td>
166
185
</tr>
167
186
<tr>
168
187
<td><p><a name="GI-INFO-TYPE-BOXED:CAPS"></a><span class="term"><code class="literal">GI_INFO_TYPE_BOXED</code></span></p></td>
169
 
<td>boxed, see <a class="link" href="gi-gistructinfo.html#GIStructInfo" title="GIStructInfo"><span class="type">GIStructInfo</span></a> or <a class="link" href="gi-giunioninfo.html#GIUnionInfo" title="GIUnionInfo"><span class="type">GIUnionInfo</span></a>
 
188
<td>boxed, see <a class="link" href="gi-GIStructInfo.html#GIStructInfo" title="GIStructInfo"><span class="type">GIStructInfo</span></a> or <a class="link" href="gi-GIUnionInfo.html#GIUnionInfo" title="GIUnionInfo"><span class="type">GIUnionInfo</span></a>
170
189
</td>
171
190
</tr>
172
191
<tr>
181
200
</tr>
182
201
<tr>
183
202
<td><p><a name="GI-INFO-TYPE-OBJECT:CAPS"></a><span class="term"><code class="literal">GI_INFO_TYPE_OBJECT</code></span></p></td>
184
 
<td>object, see <a class="link" href="gi-giobjectinfo.html#GIObjectInfo" title="GIObjectInfo"><span class="type">GIObjectInfo</span></a>
 
203
<td>object, see <a class="link" href="gi-GIObjectInfo.html#GIObjectInfo" title="GIObjectInfo"><span class="type">GIObjectInfo</span></a>
185
204
</td>
186
205
</tr>
187
206
<tr>
188
207
<td><p><a name="GI-INFO-TYPE-INTERFACE:CAPS"></a><span class="term"><code class="literal">GI_INFO_TYPE_INTERFACE</code></span></p></td>
189
 
<td>interface, see <a class="link" href="gi-giinterfaceinfo.html#GIInterfaceInfo" title="GIInterfaceInfo"><span class="type">GIInterfaceInfo</span></a>
 
208
<td>interface, see <a class="link" href="gi-GIInterfaceInfo.html#GIInterfaceInfo" title="GIInterfaceInfo"><span class="type">GIInterfaceInfo</span></a>
190
209
</td>
191
210
</tr>
192
211
<tr>
193
212
<td><p><a name="GI-INFO-TYPE-CONSTANT:CAPS"></a><span class="term"><code class="literal">GI_INFO_TYPE_CONSTANT</code></span></p></td>
194
 
<td>contant, see <a class="link" href="gi-giconstantinfo.html#GIConstantInfo" title="GIConstantInfo"><span class="type">GIConstantInfo</span></a>
 
213
<td>contant, see <a class="link" href="gi-GIConstantInfo.html#GIConstantInfo" title="GIConstantInfo"><span class="type">GIConstantInfo</span></a>
195
214
</td>
196
215
</tr>
197
216
<tr>
201
220
</tr>
202
221
<tr>
203
222
<td><p><a name="GI-INFO-TYPE-UNION:CAPS"></a><span class="term"><code class="literal">GI_INFO_TYPE_UNION</code></span></p></td>
204
 
<td>union, see <a class="link" href="gi-giunioninfo.html#GIUnionInfo" title="GIUnionInfo"><span class="type">GIUnionInfo</span></a>
 
223
<td>union, see <a class="link" href="gi-GIUnionInfo.html#GIUnionInfo" title="GIUnionInfo"><span class="type">GIUnionInfo</span></a>
205
224
</td>
206
225
</tr>
207
226
<tr>
211
230
</tr>
212
231
<tr>
213
232
<td><p><a name="GI-INFO-TYPE-SIGNAL:CAPS"></a><span class="term"><code class="literal">GI_INFO_TYPE_SIGNAL</code></span></p></td>
214
 
<td>signal, see <a class="link" href="gi-gisignalinfo.html#GISignalInfo" title="GISignalInfo"><span class="type">GISignalInfo</span></a>
 
233
<td>signal, see <a class="link" href="gi-GISignalInfo.html#GISignalInfo" title="GISignalInfo"><span class="type">GISignalInfo</span></a>
215
234
</td>
216
235
</tr>
217
236
<tr>
218
237
<td><p><a name="GI-INFO-TYPE-VFUNC:CAPS"></a><span class="term"><code class="literal">GI_INFO_TYPE_VFUNC</code></span></p></td>
219
 
<td>virtual function, see <a class="link" href="gi-givfuncinfo.html#GIVFuncInfo" title="GIVFuncInfo"><span class="type">GIVFuncInfo</span></a>
 
238
<td>virtual function, see <a class="link" href="gi-GIVFuncInfo.html#GIVFuncInfo" title="GIVFuncInfo"><span class="type">GIVFuncInfo</span></a>
220
239
</td>
221
240
</tr>
222
241
<tr>
223
242
<td><p><a name="GI-INFO-TYPE-PROPERTY:CAPS"></a><span class="term"><code class="literal">GI_INFO_TYPE_PROPERTY</code></span></p></td>
224
 
<td>GObject property, see <a class="link" href="gi-gipropertyinfo.html#GIPropertyInfo" title="GIPropertyInfo"><span class="type">GIPropertyInfo</span></a>
 
243
<td>GObject property, see <a class="link" href="gi-GIPropertyInfo.html#GIPropertyInfo" title="GIPropertyInfo"><span class="type">GIPropertyInfo</span></a>
225
244
</td>
226
245
</tr>
227
246
<tr>
249
268
</table></div>
250
269
</div>
251
270
<hr>
252
 
<div class="refsect2" title="GIAttributeIter">
 
271
<div class="refsect2">
 
272
<a name="g-info-type-to-string"></a><h3>g_info_type_to_string ()</h3>
 
273
<pre class="programlisting">const <span class="returnvalue">gchar</span> *            g_info_type_to_string          (<em class="parameter"><code><a class="link" href="gi-GIBaseInfo.html#GIInfoType" title="enum GIInfoType"><span class="type">GIInfoType</span></a> type</code></em>);</pre>
 
274
<p>
 
275
Obtain a string representation of <em class="parameter"><code>type</code></em>
 
276
</p>
 
277
<div class="variablelist"><table border="0">
 
278
<col align="left" valign="top">
 
279
<tbody>
 
280
<tr>
 
281
<td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
 
282
<td>the info type</td>
 
283
</tr>
 
284
<tr>
 
285
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
286
<td>the string</td>
 
287
</tr>
 
288
</tbody>
 
289
</table></div>
 
290
</div>
 
291
<hr>
 
292
<div class="refsect2">
253
293
<a name="GIAttributeIter"></a><h3>GIAttributeIter</h3>
254
294
<pre class="programlisting">typedef struct {
255
295
} GIAttributeIter;
260
300
</p>
261
301
</div>
262
302
<hr>
263
 
<div class="refsect2" title="GIBaseInfo">
 
303
<div class="refsect2">
264
304
<a name="GIBaseInfo"></a><h3>GIBaseInfo</h3>
265
305
<pre class="programlisting">typedef struct _GIBaseInfoStub GIBaseInfo;
266
306
</pre>
268
308
</p>
269
309
</div>
270
310
<hr>
271
 
<div class="refsect2" title="g_base_info_ref ()">
 
311
<div class="refsect2">
272
312
<a name="g-base-info-ref"></a><h3>g_base_info_ref ()</h3>
273
 
<pre class="programlisting"><a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="returnvalue">GIBaseInfo</span></a> *        g_base_info_ref                     (<em class="parameter"><code><a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="type">GIBaseInfo</span></a> *info</code></em>);</pre>
 
313
<pre class="programlisting"><a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="returnvalue">GIBaseInfo</span></a> *            g_base_info_ref                 (<em class="parameter"><code><a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="type">GIBaseInfo</span></a> *info</code></em>);</pre>
274
314
<p>
275
315
Increases the reference count of <em class="parameter"><code>info</code></em>.
276
316
</p>
284
324
</tr>
285
325
<tr>
286
326
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
287
 
<td> the same <em class="parameter"><code>info</code></em>.
288
 
</td>
 
327
<td>the same <em class="parameter"><code>info</code></em>.</td>
289
328
</tr>
290
329
</tbody>
291
330
</table></div>
292
331
</div>
293
332
<hr>
294
 
<div class="refsect2" title="g_base_info_unref ()">
 
333
<div class="refsect2">
295
334
<a name="g-base-info-unref"></a><h3>g_base_info_unref ()</h3>
296
335
<pre class="programlisting"><span class="returnvalue">void</span>                g_base_info_unref                   (<em class="parameter"><code><a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="type">GIBaseInfo</span></a> *info</code></em>);</pre>
297
336
<p>
308
347
</table></div>
309
348
</div>
310
349
<hr>
311
 
<div class="refsect2" title="g_base_info_get_type ()">
 
350
<div class="refsect2">
312
351
<a name="g-base-info-get-type"></a><h3>g_base_info_get_type ()</h3>
313
352
<pre class="programlisting"><a class="link" href="gi-GIBaseInfo.html#GIInfoType" title="enum GIInfoType"><span class="returnvalue">GIInfoType</span></a>          g_base_info_get_type                (<em class="parameter"><code><a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="type">GIBaseInfo</span></a> *info</code></em>);</pre>
314
353
<p>
324
363
</tr>
325
364
<tr>
326
365
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
327
 
<td> the info type of <em class="parameter"><code>info</code></em>
 
366
<td>the info type of <em class="parameter"><code>info</code></em>
328
367
</td>
329
368
</tr>
330
369
</tbody>
331
370
</table></div>
332
371
</div>
333
372
<hr>
334
 
<div class="refsect2" title="g_base_info_get_name ()">
 
373
<div class="refsect2">
335
374
<a name="g-base-info-get-name"></a><h3>g_base_info_get_name ()</h3>
336
 
<pre class="programlisting">const <span class="returnvalue">gchar</span> *       g_base_info_get_name                (<em class="parameter"><code><a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="type">GIBaseInfo</span></a> *info</code></em>);</pre>
 
375
<pre class="programlisting">const <span class="returnvalue">gchar</span> *           g_base_info_get_name            (<em class="parameter"><code><a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="type">GIBaseInfo</span></a> *info</code></em>);</pre>
337
376
<p>
338
377
Obtain the name of the <em class="parameter"><code>info</code></em>. What the name represents depends on
339
378
the <a class="link" href="gi-GIBaseInfo.html#GIInfoType" title="enum GIInfoType"><span class="type">GIInfoType</span></a> of the <em class="parameter"><code>info</code></em>. For instance for <a class="link" href="gi-GIFunctionInfo.html#GIFunctionInfo" title="GIFunctionInfo"><span class="type">GIFunctionInfo</span></a> it is
349
388
</tr>
350
389
<tr>
351
390
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
352
 
<td> the name of <em class="parameter"><code>info</code></em> or <code class="literal">NULL</code> if it lacks a name.
353
 
</td>
 
391
<td>the name of <em class="parameter"><code>info</code></em> or <code class="literal">NULL</code> if it lacks a name.</td>
354
392
</tr>
355
393
</tbody>
356
394
</table></div>
357
395
</div>
358
396
<hr>
359
 
<div class="refsect2" title="g_base_info_get_namespace ()">
 
397
<div class="refsect2">
360
398
<a name="g-base-info-get-namespace"></a><h3>g_base_info_get_namespace ()</h3>
361
 
<pre class="programlisting">const <span class="returnvalue">gchar</span> *       g_base_info_get_namespace           (<em class="parameter"><code><a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="type">GIBaseInfo</span></a> *info</code></em>);</pre>
 
399
<pre class="programlisting">const <span class="returnvalue">gchar</span> *           g_base_info_get_namespace       (<em class="parameter"><code><a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="type">GIBaseInfo</span></a> *info</code></em>);</pre>
362
400
<p>
363
401
Obtain the namespace of <em class="parameter"><code>info</code></em>.
364
402
</p>
372
410
</tr>
373
411
<tr>
374
412
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
375
 
<td> the namespace
376
 
</td>
 
413
<td>the namespace</td>
377
414
</tr>
378
415
</tbody>
379
416
</table></div>
380
417
</div>
381
418
<hr>
382
 
<div class="refsect2" title="g_base_info_is_deprecated ()">
 
419
<div class="refsect2">
383
420
<a name="g-base-info-is-deprecated"></a><h3>g_base_info_is_deprecated ()</h3>
384
421
<pre class="programlisting"><span class="returnvalue">gboolean</span>            g_base_info_is_deprecated           (<em class="parameter"><code><a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="type">GIBaseInfo</span></a> *info</code></em>);</pre>
385
422
<p>
396
433
</tr>
397
434
<tr>
398
435
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
399
 
<td> <code class="literal">TRUE</code> if deprecated
400
 
</td>
 
436
<td>
 
437
<code class="literal">TRUE</code> if deprecated</td>
401
438
</tr>
402
439
</tbody>
403
440
</table></div>
404
441
</div>
405
442
<hr>
406
 
<div class="refsect2" title="g_base_info_get_attribute ()">
 
443
<div class="refsect2">
407
444
<a name="g-base-info-get-attribute"></a><h3>g_base_info_get_attribute ()</h3>
408
 
<pre class="programlisting">const <span class="returnvalue">gchar</span> *       g_base_info_get_attribute           (<em class="parameter"><code><a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="type">GIBaseInfo</span></a> *info</code></em>,
 
445
<pre class="programlisting">const <span class="returnvalue">gchar</span> *           g_base_info_get_attribute       (<em class="parameter"><code><a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="type">GIBaseInfo</span></a> *info</code></em>,
409
446
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>);</pre>
410
447
<p>
411
448
Retrieve an arbitrary attribute associated with this node.
420
457
</tr>
421
458
<tr>
422
459
<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
423
 
<td>a freeform string naming an attribute
424
 
</td>
 
460
<td>a freeform string naming an attribute</td>
425
461
</tr>
426
462
<tr>
427
463
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
428
 
<td> The value of the attribute, or <code class="literal">NULL</code> if no such attribute exists
429
 
</td>
 
464
<td>The value of the attribute, or <code class="literal">NULL</code> if no such attribute exists</td>
430
465
</tr>
431
466
</tbody>
432
467
</table></div>
433
468
</div>
434
469
<hr>
435
 
<div class="refsect2" title="g_base_info_iterate_attributes ()">
 
470
<div class="refsect2">
436
471
<a name="g-base-info-iterate-attributes"></a><h3>g_base_info_iterate_attributes ()</h3>
437
472
<pre class="programlisting"><span class="returnvalue">gboolean</span>            g_base_info_iterate_attributes      (<em class="parameter"><code><a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="type">GIBaseInfo</span></a> *info</code></em>,
438
473
                                                         <em class="parameter"><code><a class="link" href="gi-GIBaseInfo.html#GIAttributeIter" title="GIAttributeIter"><span class="type">GIAttributeIter</span></a> *iterator</code></em>,
450
485
<p>
451
486
</p>
452
487
<div class="example">
453
 
<a name="id2866605"></a><p class="title"><b>Example 3. Iterating over attributes</b></p>
 
488
<a name="id495674"></a><p class="title"><b>Example 3. Iterating over attributes</b></p>
454
489
<div class="example-contents">
455
490
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
456
491
    <tbody>
467
502
10
468
503
11</pre></td>
469
504
        <td class="listing_code"><pre class="programlisting"><span class="type">void</span>
470
 
<span class="function">print_attributes</span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="gi-GIBaseInfo.html#GIBaseInfo">GIBaseInfo</a> </span><span class="symbol">*</span><span class="normal">info</span><span class="symbol">)</span>
471
 
<span class="cbracket">{</span>
472
 
<span class="normal">  <a href="gi-GIBaseInfo.html#GIAttributeIter">GIAttributeIter</a> iter </span><span class="symbol">=</span><span class="normal"> </span><span class="cbracket">{</span><span class="normal"> </span><span class="number">0</span><span class="symbol">,</span><span class="normal"> </span><span class="cbracket">}</span><span class="symbol">;</span>
473
 
<span class="normal">  </span><span class="type">char</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">name</span><span class="symbol">;</span>
474
 
<span class="normal">  </span><span class="type">char</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">value</span><span class="symbol">;</span>
475
 
<span class="normal">  </span><span class="keyword">while</span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="gi-GIBaseInfo.html#g-base-info-iterate-attributes">g_base_info_iterate_attributes</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">info</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">iter</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">name</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">value</span><span class="symbol">))</span>
476
 
<span class="normal">    </span><span class="cbracket">{</span>
477
 
<span class="normal">      </span><span class="function">g_print</span><span class="normal"> </span><span class="symbol">(</span><span class="string">"attribute name: %s value: %s"</span><span class="symbol">,</span><span class="normal"> name</span><span class="symbol">,</span><span class="normal"> value</span><span class="symbol">);</span>
478
 
<span class="normal">    </span><span class="cbracket">}</span>
479
 
<span class="cbracket">}</span></pre></td>
 
505
print_attributes (GIBaseInfo *info)
 
506
{
 
507
  GIAttributeIter iter = { <span class="number">0</span>, };
 
508
  <span class="type">char</span> *name;
 
509
  <span class="type">char</span> *value;
 
510
  <span class="keyword">while</span> (g_base_info_iterate_attributes (info, &amp;iter, &amp;name, &amp;value))
 
511
    {
 
512
      g_print (<span class="number">&quot;attribute name: </span><span class="symbol">%s</span><span class="number"> value: </span><span class="symbol">%s</span><span class="number">&quot;</span>, name, value);
 
513
    }
 
514
}</pre></td>
480
515
      </tr>
481
516
    </tbody>
482
517
  </table>
495
530
</tr>
496
531
<tr>
497
532
<td><p><span class="term"><em class="parameter"><code>iterator</code></em> :</span></p></td>
498
 
<td>a <a class="link" href="gi-GIBaseInfo.html#GIAttributeIter" title="GIAttributeIter"><span class="type">GIAttributeIter</span></a> structure, must be initialized; see below
 
533
<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>
 
534
</tr>
 
535
<tr>
 
536
<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
 
537
<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>
499
538
</td>
500
539
</tr>
501
540
<tr>
502
 
<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
503
 
<td> Returned name, must not be freed. <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>. </td>
504
 
</tr>
505
 
<tr>
506
541
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
507
 
<td> Returned name, must not be freed. <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>. </td>
 
542
<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>
 
543
</td>
508
544
</tr>
509
545
<tr>
510
546
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
511
 
<td> <code class="literal">TRUE</code> if there are more attributes
512
 
</td>
 
547
<td>
 
548
<code class="literal">TRUE</code> if there are more attributes</td>
513
549
</tr>
514
550
</tbody>
515
551
</table></div>
516
552
</div>
517
553
<hr>
518
 
<div class="refsect2" title="g_base_info_get_container ()">
 
554
<div class="refsect2">
519
555
<a name="g-base-info-get-container"></a><h3>g_base_info_get_container ()</h3>
520
 
<pre class="programlisting"><a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="returnvalue">GIBaseInfo</span></a> *        g_base_info_get_container           (<em class="parameter"><code><a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="type">GIBaseInfo</span></a> *info</code></em>);</pre>
 
556
<pre class="programlisting"><a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="returnvalue">GIBaseInfo</span></a> *            g_base_info_get_container       (<em class="parameter"><code><a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="type">GIBaseInfo</span></a> *info</code></em>);</pre>
521
557
<p>
522
558
Obtain the container of the <em class="parameter"><code>info</code></em>. The container is the parent
523
559
GIBaseInfo. For instance, the parent of a <a class="link" href="gi-GIFunctionInfo.html#GIFunctionInfo" title="GIFunctionInfo"><span class="type">GIFunctionInfo</span></a> is an
524
 
<a class="link" href="gi-giobjectinfo.html#GIObjectInfo" title="GIObjectInfo"><span class="type">GIObjectInfo</span></a> or <a class="link" href="gi-giinterfaceinfo.html#GIInterfaceInfo" title="GIInterfaceInfo"><span class="type">GIInterfaceInfo</span></a>.
 
560
<a class="link" href="gi-GIObjectInfo.html#GIObjectInfo" title="GIObjectInfo"><span class="type">GIObjectInfo</span></a> or <a class="link" href="gi-GIInterfaceInfo.html#GIInterfaceInfo" title="GIInterfaceInfo"><span class="type">GIInterfaceInfo</span></a>.
525
561
</p>
526
562
<div class="variablelist"><table border="0">
527
563
<col align="left" valign="top">
533
569
</tr>
534
570
<tr>
535
571
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
536
 
<td> the container. <acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>. </td>
 
572
<td>the container. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
 
573
</td>
537
574
</tr>
538
575
</tbody>
539
576
</table></div>
540
577
</div>
541
578
<hr>
542
 
<div class="refsect2" title="g_base_info_get_typelib ()">
 
579
<div class="refsect2">
543
580
<a name="g-base-info-get-typelib"></a><h3>g_base_info_get_typelib ()</h3>
544
 
<pre class="programlisting"><a class="link" href="gi-girepository.html#GTypelib" title="GTypelib"><span class="returnvalue">GTypelib</span></a> *          g_base_info_get_typelib             (<em class="parameter"><code><a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="type">GIBaseInfo</span></a> *info</code></em>);</pre>
 
581
<pre class="programlisting"><a class="link" href="gi-girepository.html#GITypelib" title="GITypelib"><span class="returnvalue">GITypelib</span></a> *              g_base_info_get_typelib        (<em class="parameter"><code><a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="type">GIBaseInfo</span></a> *info</code></em>);</pre>
545
582
<p>
546
583
Obtain the typelib this <em class="parameter"><code>info</code></em> belongs to
547
584
</p>
555
592
</tr>
556
593
<tr>
557
594
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
558
 
<td> the typelib.. <acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>. </td>
 
595
<td>the typelib. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
 
596
</td>
559
597
</tr>
560
598
</tbody>
561
599
</table></div>
562
600
</div>
563
601
<hr>
564
 
<div class="refsect2" title="g_base_info_equal ()">
 
602
<div class="refsect2">
565
603
<a name="g-base-info-equal"></a><h3>g_base_info_equal ()</h3>
566
604
<pre class="programlisting"><span class="returnvalue">gboolean</span>            g_base_info_equal                   (<em class="parameter"><code><a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="type">GIBaseInfo</span></a> *info1</code></em>,
567
605
                                                         <em class="parameter"><code><a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="type">GIBaseInfo</span></a> *info2</code></em>);</pre>
588
626
</tr>
589
627
<tr>
590
628
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
591
 
<td> <code class="literal">TRUE</code> if and only if <em class="parameter"><code>info1</code></em> equals <em class="parameter"><code>info2</code></em>.
592
 
</td>
 
629
<td>
 
630
<code class="literal">TRUE</code> if and only if <em class="parameter"><code>info1</code></em> equals <em class="parameter"><code>info2</code></em>.</td>
593
631
</tr>
594
632
</tbody>
595
633
</table></div>
598
636
</div>
599
637
<div class="footer">
600
638
<hr>
601
 
          Generated by GTK-Doc V1.14</div>
 
639
          Generated by GTK-Doc V1.16.1</div>
602
640
</body>
603
641
</html>
 
 
b'\\ No newline at end of file'