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>GIRepository: GObject Introspection Reference Manual</title>
6 <meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
7 <link rel="home" href="index.html" title="GObject Introspection Reference Manual">
8 <link rel="up" href="ch01.html" title="GIRepository">
9 <link rel="prev" href="ch01.html" title="GIRepository">
10 <link rel="next" href="gi-struct-hierarchy.html" title="Struct hierarchy">
11 <meta name="generator" content="GTK-Doc V1.25.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="5"><tr valign="middle">
16 <td width="100%" align="left" class="shortcuts">
17 <a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span>
18 <a href="#GIRepository.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span>
19 <a href="#GIRepository.object-hierarchy" class="shortcut">Object Hierarchy</a></span>
21 <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
22 <td><a accesskey="u" href="ch01.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
23 <td><a accesskey="p" href="ch01.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
24 <td><a accesskey="n" href="gi-struct-hierarchy.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
26 <div class="refentry">
27 <a name="GIRepository"></a><div class="titlepage"></div>
28 <div class="refnamediv"><table width="100%"><tr>
30 <h2><span class="refentrytitle"><a name="GIRepository.top_of_page"></a>GIRepository</span></h2>
31 <p>GIRepository — GObject Introspection repository manager</p>
33 <td class="gallery_image" valign="top" align="right"></td>
35 <div class="refsect1">
36 <a name="GIRepository.functions"></a><h2>Functions</h2>
37 <div class="informaltable"><table class="informaltable" width="100%" border="0">
39 <col width="150px" class="functions_return">
40 <col class="functions_name">
44 <td class="function_type">
45 <a class="link" href="GIRepository.html" title="GIRepository"><span class="returnvalue">GIRepository</span></a> *
47 <td class="function_name">
48 <a class="link" href="GIRepository.html#g-irepository-get-default" title="g_irepository_get_default ()">g_irepository_get_default</a> <span class="c_punctuation">()</span>
52 <td class="function_type">
53 <span class="returnvalue">gchar</span> **
55 <td class="function_name">
56 <a class="link" href="GIRepository.html#g-irepository-get-dependencies" title="g_irepository_get_dependencies ()">g_irepository_get_dependencies</a> <span class="c_punctuation">()</span>
60 <td class="function_type">
61 <span class="returnvalue">gchar</span> **
63 <td class="function_name">
64 <a class="link" href="GIRepository.html#g-irepository-get-immediate-dependencies" title="g_irepository_get_immediate_dependencies ()">g_irepository_get_immediate_dependencies</a> <span class="c_punctuation">()</span>
68 <td class="function_type">
69 <span class="returnvalue">gchar</span> **
71 <td class="function_name">
72 <a class="link" href="GIRepository.html#g-irepository-get-loaded-namespaces" title="g_irepository_get_loaded_namespaces ()">g_irepository_get_loaded_namespaces</a> <span class="c_punctuation">()</span>
76 <td class="function_type">
77 <span class="returnvalue">gint</span>
79 <td class="function_name">
80 <a class="link" href="GIRepository.html#g-irepository-get-n-infos" title="g_irepository_get_n_infos ()">g_irepository_get_n_infos</a> <span class="c_punctuation">()</span>
84 <td class="function_type">
85 <span class="returnvalue">GIBaseInfo</span> *
87 <td class="function_name">
88 <a class="link" href="GIRepository.html#g-irepository-get-info" title="g_irepository_get_info ()">g_irepository_get_info</a> <span class="c_punctuation">()</span>
92 <td class="function_type">
93 <span class="returnvalue">GOptionGroup</span> *
95 <td class="function_name">
96 <a class="link" href="GIRepository.html#g-irepository-get-option-group" title="g_irepository_get_option_group ()">g_irepository_get_option_group</a> <span class="c_punctuation">()</span>
100 <td class="function_type">
101 <span class="returnvalue">GList</span> *
103 <td class="function_name">
104 <a class="link" href="GIRepository.html#g-irepository-enumerate-versions" title="g_irepository_enumerate_versions ()">g_irepository_enumerate_versions</a> <span class="c_punctuation">()</span>
108 <td class="function_type">
109 <span class="returnvalue">void</span>
111 <td class="function_name">
112 <a class="link" href="GIRepository.html#g-irepository-prepend-library-path" title="g_irepository_prepend_library_path ()">g_irepository_prepend_library_path</a> <span class="c_punctuation">()</span>
116 <td class="function_type">
117 <span class="returnvalue">void</span>
119 <td class="function_name">
120 <a class="link" href="GIRepository.html#g-irepository-prepend-search-path" title="g_irepository_prepend_search_path ()">g_irepository_prepend_search_path</a> <span class="c_punctuation">()</span>
124 <td class="function_type">
125 <span class="returnvalue">GSList</span> *
127 <td class="function_name">
128 <a class="link" href="GIRepository.html#g-irepository-get-search-path" title="g_irepository_get_search_path ()">g_irepository_get_search_path</a> <span class="c_punctuation">()</span>
132 <td class="function_type">const <span class="returnvalue">char</span> *
134 <td class="function_name">
135 <a class="link" href="GIRepository.html#g-irepository-load-typelib" title="g_irepository_load_typelib ()">g_irepository_load_typelib</a> <span class="c_punctuation">()</span>
139 <td class="function_type">const <span class="returnvalue">gchar</span> *
141 <td class="function_name">
142 <a class="link" href="GIRepository.html#g-irepository-get-typelib-path" title="g_irepository_get_typelib_path ()">g_irepository_get_typelib_path</a> <span class="c_punctuation">()</span>
146 <td class="function_type">
147 <span class="returnvalue">gboolean</span>
149 <td class="function_name">
150 <a class="link" href="GIRepository.html#g-irepository-is-registered" title="g_irepository_is_registered ()">g_irepository_is_registered</a> <span class="c_punctuation">()</span>
154 <td class="function_type">
155 <a class="link" href="gi-gitypelib.html#GITypelib" title="GITypelib"><span class="returnvalue">GITypelib</span></a> *
157 <td class="function_name">
158 <a class="link" href="GIRepository.html#g-irepository-require" title="g_irepository_require ()">g_irepository_require</a> <span class="c_punctuation">()</span>
162 <td class="function_type">
163 <a class="link" href="gi-gitypelib.html#GITypelib" title="GITypelib"><span class="returnvalue">GITypelib</span></a> *
165 <td class="function_name">
166 <a class="link" href="GIRepository.html#g-irepository-require-private" title="g_irepository_require_private ()">g_irepository_require_private</a> <span class="c_punctuation">()</span>
170 <td class="function_type">const <span class="returnvalue">gchar</span> *
172 <td class="function_name">
173 <a class="link" href="GIRepository.html#g-irepository-get-c-prefix" title="g_irepository_get_c_prefix ()">g_irepository_get_c_prefix</a> <span class="c_punctuation">()</span>
177 <td class="function_type">const <span class="returnvalue">gchar</span> *
179 <td class="function_name">
180 <a class="link" href="GIRepository.html#g-irepository-get-shared-library" title="g_irepository_get_shared_library ()">g_irepository_get_shared_library</a> <span class="c_punctuation">()</span>
184 <td class="function_type">const <span class="returnvalue">gchar</span> *
186 <td class="function_name">
187 <a class="link" href="GIRepository.html#g-irepository-get-version" title="g_irepository_get_version ()">g_irepository_get_version</a> <span class="c_punctuation">()</span>
191 <td class="function_type">
192 <span class="returnvalue">GIBaseInfo</span> *
194 <td class="function_name">
195 <a class="link" href="GIRepository.html#g-irepository-find-by-gtype" title="g_irepository_find_by_gtype ()">g_irepository_find_by_gtype</a> <span class="c_punctuation">()</span>
199 <td class="function_type">
200 <a class="link" href="gi-GIEnumInfo.html#GIEnumInfo" title="GIEnumInfo"><span class="returnvalue">GIEnumInfo</span></a> *
202 <td class="function_name">
203 <a class="link" href="GIRepository.html#g-irepository-find-by-error-domain" title="g_irepository_find_by_error_domain ()">g_irepository_find_by_error_domain</a> <span class="c_punctuation">()</span>
207 <td class="function_type">
208 <span class="returnvalue">GIBaseInfo</span> *
210 <td class="function_name">
211 <a class="link" href="GIRepository.html#g-irepository-find-by-name" title="g_irepository_find_by_name ()">g_irepository_find_by_name</a> <span class="c_punctuation">()</span>
215 <td class="function_type">
216 <span class="returnvalue">gboolean</span>
218 <td class="function_name">
219 <a class="link" href="GIRepository.html#g-irepository-dump" title="g_irepository_dump ()">g_irepository_dump</a> <span class="c_punctuation">()</span>
223 <td class="function_type">
224 <span class="returnvalue">void</span>
226 <td class="function_name">
227 <a class="link" href="GIRepository.html#gi-cclosure-marshal-generic" title="gi_cclosure_marshal_generic ()">gi_cclosure_marshal_generic</a> <span class="c_punctuation">()</span>
233 <div class="refsect1">
234 <a name="GIRepository.other"></a><h2>Types and Values</h2>
235 <div class="informaltable"><table class="informaltable" width="100%" border="0">
237 <col width="150px" class="name">
238 <col class="description">
242 <td class="datatype_keyword">struct</td>
243 <td class="function_name"><a class="link" href="GIRepository.html#GIRepository-struct" title="struct GIRepository">GIRepository</a></td>
246 <td class="datatype_keyword">enum</td>
247 <td class="function_name"><a class="link" href="GIRepository.html#GIRepositoryLoadFlags" title="enum GIRepositoryLoadFlags">GIRepositoryLoadFlags</a></td>
250 <td class="define_keyword">#define</td>
251 <td class="function_name"><a class="link" href="GIRepository.html#G-IREPOSITORY-ERROR:CAPS" title="G_IREPOSITORY_ERROR">G_IREPOSITORY_ERROR</a></td>
254 <td class="datatype_keyword">enum</td>
255 <td class="function_name"><a class="link" href="GIRepository.html#GIRepositoryError" title="enum GIRepositoryError">GIRepositoryError</a></td>
260 <div class="refsect1">
261 <a name="GIRepository.object-hierarchy"></a><h2>Object Hierarchy</h2>
262 <pre class="screen"> GObject
263 <span class="lineart">╰──</span> GIRepository
266 <div class="refsect1">
267 <a name="GIRepository.includes"></a><h2>Includes</h2>
268 <pre class="synopsis">#include <girepository.h>
271 <div class="refsect1">
272 <a name="GIRepository.description"></a><h2>Description</h2>
273 <p><a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a> is used to manage repositories of namespaces. Namespaces
274 are represented on disk by type libraries (.typelib files).</p>
276 <div class="refsect1">
277 <a name="GIRepository.functions_details"></a><h2>Functions</h2>
278 <div class="refsect2">
279 <a name="g-irepository-get-default"></a><h3>g_irepository_get_default ()</h3>
280 <pre class="programlisting"><a class="link" href="GIRepository.html" title="GIRepository"><span class="returnvalue">GIRepository</span></a> *
281 g_irepository_get_default (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
282 <p>Returns the singleton process-global default <a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a>. It is
283 not currently supported to have multiple repositories in a
284 particular process, but this function is provided in the unlikely
285 eventuality that it would become possible, and as a convenience for
286 higher level language bindings to conform to the GObject method
287 call conventions.</p>
288 <p>All methods on <a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a> also accept <code class="literal">NULL</code> as an instance
289 parameter to mean this default repository, which is usually more
290 convenient for C.</p>
291 <div class="refsect3">
292 <a name="g-irepository-get-default.returns"></a><h4>Returns</h4>
293 <p> The global singleton <a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a>. </p>
294 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
298 <div class="refsect2">
299 <a name="g-irepository-get-dependencies"></a><h3>g_irepository_get_dependencies ()</h3>
300 <pre class="programlisting"><span class="returnvalue">gchar</span> **
301 g_irepository_get_dependencies (<em class="parameter"><code><a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a> *repository</code></em>,
302 <em class="parameter"><code>const <span class="type">gchar</span> *namespace_</code></em>);</pre>
303 <p>Return an array of all (transitive) versioned dependencies for
304 <em class="parameter"><code>namespace_</code></em>
305 . Returned strings are of the form</p>
306 <code class="code">namespace-version</code>.
307 <p>Note: <em class="parameter"><code>namespace_</code></em>
308 must have already been loaded using a function
309 such as <a class="link" href="GIRepository.html#g-irepository-require" title="g_irepository_require ()"><code class="function">g_irepository_require()</code></a> before calling this function.</p>
310 <p>To get only the immediate dependencies for <em class="parameter"><code>namespace_</code></em>
312 <a class="link" href="GIRepository.html#g-irepository-get-immediate-dependencies" title="g_irepository_get_immediate_dependencies ()"><code class="function">g_irepository_get_immediate_dependencies()</code></a>.</p>
313 <div class="refsect3">
314 <a name="g-irepository-get-dependencies.parameters"></a><h4>Parameters</h4>
315 <div class="informaltable"><table class="informaltable" width="100%" border="0">
317 <col width="150px" class="parameters_name">
318 <col class="parameters_description">
319 <col width="200px" class="parameters_annotations">
323 <td class="parameter_name"><p>repository</p></td>
324 <td class="parameter_description"><p> A <a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a> or <code class="literal">NULL</code> for the singleton
325 process-global default <a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a>. </p></td>
326 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
329 <td class="parameter_name"><p>namespace_</p></td>
330 <td class="parameter_description"><p>Namespace of interest</p></td>
331 <td class="parameter_annotations"> </td>
336 <div class="refsect3">
337 <a name="g-irepository-get-dependencies.returns"></a><h4>Returns</h4>
338 <p> Zero-terminated string array of all versioned
340 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
344 <div class="refsect2">
345 <a name="g-irepository-get-immediate-dependencies"></a><h3>g_irepository_get_immediate_dependencies ()</h3>
346 <pre class="programlisting"><span class="returnvalue">gchar</span> **
347 g_irepository_get_immediate_dependencies
348 (<em class="parameter"><code><a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a> *repository</code></em>,
349 <em class="parameter"><code>const <span class="type">gchar</span> *namespace_</code></em>);</pre>
350 <p>Return an array of the immediate versioned dependencies for <em class="parameter"><code>namespace_</code></em>
352 Returned strings are of the form <code class="code">namespace-version</code>.</p>
353 <p>Note: <em class="parameter"><code>namespace_</code></em>
354 must have already been loaded using a function
355 such as <a class="link" href="GIRepository.html#g-irepository-require" title="g_irepository_require ()"><code class="function">g_irepository_require()</code></a> before calling this function.</p>
356 <p>To get the transitive closure of dependencies for <em class="parameter"><code>namespace_</code></em>
358 <a class="link" href="GIRepository.html#g-irepository-get-dependencies" title="g_irepository_get_dependencies ()"><code class="function">g_irepository_get_dependencies()</code></a>.</p>
359 <div class="refsect3">
360 <a name="g-irepository-get-immediate-dependencies.parameters"></a><h4>Parameters</h4>
361 <div class="informaltable"><table class="informaltable" width="100%" border="0">
363 <col width="150px" class="parameters_name">
364 <col class="parameters_description">
365 <col width="200px" class="parameters_annotations">
369 <td class="parameter_name"><p>repository</p></td>
370 <td class="parameter_description"><p> A <a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a> or <code class="literal">NULL</code> for the singleton
371 process-global default <a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a>. </p></td>
372 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
375 <td class="parameter_name"><p>namespace_</p></td>
376 <td class="parameter_description"><p>Namespace of interest</p></td>
377 <td class="parameter_annotations"> </td>
382 <div class="refsect3">
383 <a name="g-irepository-get-immediate-dependencies.returns"></a><h4>Returns</h4>
384 <p> Zero-terminated string array of immediate versioned
386 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
388 <p class="since">Since: 1.44</p>
391 <div class="refsect2">
392 <a name="g-irepository-get-loaded-namespaces"></a><h3>g_irepository_get_loaded_namespaces ()</h3>
393 <pre class="programlisting"><span class="returnvalue">gchar</span> **
394 g_irepository_get_loaded_namespaces (<em class="parameter"><code><a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a> *repository</code></em>);</pre>
395 <p>Return the list of currently loaded namespaces.</p>
396 <div class="refsect3">
397 <a name="g-irepository-get-loaded-namespaces.parameters"></a><h4>Parameters</h4>
398 <div class="informaltable"><table class="informaltable" width="100%" border="0">
400 <col width="150px" class="parameters_name">
401 <col class="parameters_description">
402 <col width="200px" class="parameters_annotations">
405 <td class="parameter_name"><p>repository</p></td>
406 <td class="parameter_description"><p> A <a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a> or <code class="literal">NULL</code> for the singleton
407 process-global default <a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a>. </p></td>
408 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
412 <div class="refsect3">
413 <a name="g-irepository-get-loaded-namespaces.returns"></a><h4>Returns</h4>
414 <p> List of namespaces. </p>
415 <p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
419 <div class="refsect2">
420 <a name="g-irepository-get-n-infos"></a><h3>g_irepository_get_n_infos ()</h3>
421 <pre class="programlisting"><span class="returnvalue">gint</span>
422 g_irepository_get_n_infos (<em class="parameter"><code><a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a> *repository</code></em>,
423 <em class="parameter"><code>const <span class="type">gchar</span> *namespace_</code></em>);</pre>
424 <p>This function returns the number of metadata entries in
425 given namespace <em class="parameter"><code>namespace_</code></em>
426 . The namespace must have
427 already been loaded before calling this function.</p>
428 <div class="refsect3">
429 <a name="g-irepository-get-n-infos.parameters"></a><h4>Parameters</h4>
430 <div class="informaltable"><table class="informaltable" width="100%" border="0">
432 <col width="150px" class="parameters_name">
433 <col class="parameters_description">
434 <col width="200px" class="parameters_annotations">
438 <td class="parameter_name"><p>repository</p></td>
439 <td class="parameter_description"><p> A <a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a> or <code class="literal">NULL</code> for the singleton
440 process-global default <a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a>. </p></td>
441 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
444 <td class="parameter_name"><p>namespace_</p></td>
445 <td class="parameter_description"><p>Namespace to inspect</p></td>
446 <td class="parameter_annotations"> </td>
451 <div class="refsect3">
452 <a name="g-irepository-get-n-infos.returns"></a><h4>Returns</h4>
453 <p> number of metadata entries</p>
457 <div class="refsect2">
458 <a name="g-irepository-get-info"></a><h3>g_irepository_get_info ()</h3>
459 <pre class="programlisting"><span class="returnvalue">GIBaseInfo</span> *
460 g_irepository_get_info (<em class="parameter"><code><a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a> *repository</code></em>,
461 <em class="parameter"><code>const <span class="type">gchar</span> *namespace_</code></em>,
462 <em class="parameter"><code><span class="type">gint</span> index</code></em>);</pre>
463 <p>This function returns a particular metadata entry in the
464 given namespace <em class="parameter"><code>namespace_</code></em>
465 . The namespace must have
466 already been loaded before calling this function.
467 See <a class="link" href="GIRepository.html#g-irepository-get-n-infos" title="g_irepository_get_n_infos ()"><code class="function">g_irepository_get_n_infos()</code></a> to find the maximum number of
469 <div class="refsect3">
470 <a name="g-irepository-get-info.parameters"></a><h4>Parameters</h4>
471 <div class="informaltable"><table class="informaltable" width="100%" border="0">
473 <col width="150px" class="parameters_name">
474 <col class="parameters_description">
475 <col width="200px" class="parameters_annotations">
479 <td class="parameter_name"><p>repository</p></td>
480 <td class="parameter_description"><p> A <a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a> or <code class="literal">NULL</code> for the singleton
481 process-global default <a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a>. </p></td>
482 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
485 <td class="parameter_name"><p>namespace_</p></td>
486 <td class="parameter_description"><p>Namespace to inspect</p></td>
487 <td class="parameter_annotations"> </td>
490 <td class="parameter_name"><p>index</p></td>
491 <td class="parameter_description"><p>0-based offset into namespace metadata for entry</p></td>
492 <td class="parameter_annotations"> </td>
497 <div class="refsect3">
498 <a name="g-irepository-get-info.returns"></a><h4>Returns</h4>
499 <p> <span class="type">GIBaseInfo</span> containing metadata. </p>
500 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
504 <div class="refsect2">
505 <a name="g-irepository-get-option-group"></a><h3>g_irepository_get_option_group ()</h3>
506 <pre class="programlisting"><span class="returnvalue">GOptionGroup</span> *
507 g_irepository_get_option_group (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
508 <p>Obtain the option group for girepository, it's used
509 by the dumper and for programs that wants to provide
510 introspection information</p>
511 <p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
512 <div class="refsect3">
513 <a name="g-irepository-get-option-group.returns"></a><h4>Returns</h4>
514 <p> the option group. </p>
515 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
519 <div class="refsect2">
520 <a name="g-irepository-enumerate-versions"></a><h3>g_irepository_enumerate_versions ()</h3>
521 <pre class="programlisting"><span class="returnvalue">GList</span> *
522 g_irepository_enumerate_versions (<em class="parameter"><code><a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a> *repository</code></em>,
523 <em class="parameter"><code>const <span class="type">gchar</span> *namespace_</code></em>);</pre>
524 <p>Obtain an unordered list of versions (either currently loaded or
525 available) for <em class="parameter"><code>namespace_</code></em>
526 in this <em class="parameter"><code>repository</code></em>
528 <div class="refsect3">
529 <a name="g-irepository-enumerate-versions.parameters"></a><h4>Parameters</h4>
530 <div class="informaltable"><table class="informaltable" width="100%" border="0">
532 <col width="150px" class="parameters_name">
533 <col class="parameters_description">
534 <col width="200px" class="parameters_annotations">
538 <td class="parameter_name"><p>repository</p></td>
539 <td class="parameter_description"><p> A <a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a> or <code class="literal">NULL</code> for the singleton
540 process-global default <a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a>. </p></td>
541 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
544 <td class="parameter_name"><p>namespace_</p></td>
545 <td class="parameter_description"><p>GI namespace, e.g. "Gtk"</p></td>
546 <td class="parameter_annotations"> </td>
551 <div class="refsect3">
552 <a name="g-irepository-enumerate-versions.returns"></a><h4>Returns</h4>
553 <p> the array of versions. </p>
554 <p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
558 <div class="refsect2">
559 <a name="g-irepository-prepend-library-path"></a><h3>g_irepository_prepend_library_path ()</h3>
560 <pre class="programlisting"><span class="returnvalue">void</span>
561 g_irepository_prepend_library_path (<em class="parameter"><code>const <span class="type">char</span> *directory</code></em>);</pre>
562 <p>Prepends <em class="parameter"><code>directory</code></em>
563 to the search path that is used to
564 search shared libraries referenced by imported namespaces.
565 Multiple calls to this function all contribute to the final
567 The list of paths is unique and shared for all <a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a>
568 instances across the process, but it doesn't affect namespaces
569 imported before the call.</p>
570 <p>If the library is not found in the directories configured
571 in this way, loading will fall back to the system library
572 path (ie. LD_LIBRARY_PATH and DT_RPATH in ELF systems).
573 See the documentation of your dynamic linker for full details.</p>
574 <div class="refsect3">
575 <a name="g-irepository-prepend-library-path.parameters"></a><h4>Parameters</h4>
576 <div class="informaltable"><table class="informaltable" width="100%" border="0">
578 <col width="150px" class="parameters_name">
579 <col class="parameters_description">
580 <col width="200px" class="parameters_annotations">
583 <td class="parameter_name"><p>directory</p></td>
584 <td class="parameter_description"><p> a single directory to scan for shared libraries. </p></td>
585 <td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span></td>
589 <p class="since">Since: <a class="link" href="api-index-1-35-8.html#api-index-1.35.8">1.35.8</a></p>
592 <div class="refsect2">
593 <a name="g-irepository-prepend-search-path"></a><h3>g_irepository_prepend_search_path ()</h3>
594 <pre class="programlisting"><span class="returnvalue">void</span>
595 g_irepository_prepend_search_path (<em class="parameter"><code>const <span class="type">char</span> *directory</code></em>);</pre>
596 <p>Prepends <em class="parameter"><code>directory</code></em>
597 to the typelib search path.
598 See <a class="link" href="GIRepository.html#g-irepository-get-search-path" title="g_irepository_get_search_path ()"><code class="function">g_irepository_get_search_path()</code></a>.</p>
599 <div class="refsect3">
600 <a name="g-irepository-prepend-search-path.parameters"></a><h4>Parameters</h4>
601 <div class="informaltable"><table class="informaltable" width="100%" border="0">
603 <col width="150px" class="parameters_name">
604 <col class="parameters_description">
605 <col width="200px" class="parameters_annotations">
608 <td class="parameter_name"><p>directory</p></td>
609 <td class="parameter_description"><p> directory name to prepend to the typelib
610 search path. </p></td>
611 <td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span></td>
617 <div class="refsect2">
618 <a name="g-irepository-get-search-path"></a><h3>g_irepository_get_search_path ()</h3>
619 <pre class="programlisting"><span class="returnvalue">GSList</span> *
620 g_irepository_get_search_path (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
621 <p>Returns the current search path <a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a> will use when loading
622 typelib files. The list is internal to <span class="type">GIRespository</span> and should not
623 be freed, nor should its string elements.</p>
624 <div class="refsect3">
625 <a name="g-irepository-get-search-path.returns"></a><h4>Returns</h4>
626 <p> <span class="type">GSList</span> of strings. </p>
627 <p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> filename][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
631 <div class="refsect2">
632 <a name="g-irepository-load-typelib"></a><h3>g_irepository_load_typelib ()</h3>
633 <pre class="programlisting">const <span class="returnvalue">char</span> *
634 g_irepository_load_typelib (<em class="parameter"><code><a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a> *repository</code></em>,
635 <em class="parameter"><code><a class="link" href="gi-gitypelib.html#GITypelib" title="GITypelib"><span class="type">GITypelib</span></a> *typelib</code></em>,
636 <em class="parameter"><code><a class="link" href="GIRepository.html#GIRepositoryLoadFlags" title="enum GIRepositoryLoadFlags"><span class="type">GIRepositoryLoadFlags</span></a> flags</code></em>,
637 <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
639 <div class="refsect3">
640 <a name="g-irepository-load-typelib.parameters"></a><h4>Parameters</h4>
641 <div class="informaltable"><table class="informaltable" width="100%" border="0">
643 <col width="150px" class="parameters_name">
644 <col class="parameters_description">
645 <col width="200px" class="parameters_annotations">
649 <td class="parameter_name"><p>repository</p></td>
650 <td class="parameter_description"><p> A <a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a> or <code class="literal">NULL</code> for the singleton
651 process-global default <a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a>. </p></td>
652 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
655 <td class="parameter_name"><p>typelib</p></td>
656 <td class="parameter_description"><p>TODO</p></td>
657 <td class="parameter_annotations"> </td>
660 <td class="parameter_name"><p>flags</p></td>
661 <td class="parameter_description"><p>TODO</p></td>
662 <td class="parameter_annotations"> </td>
665 <td class="parameter_name"><p>error</p></td>
666 <td class="parameter_description"><p>TODO</p></td>
667 <td class="parameter_annotations"> </td>
674 <div class="refsect2">
675 <a name="g-irepository-get-typelib-path"></a><h3>g_irepository_get_typelib_path ()</h3>
676 <pre class="programlisting">const <span class="returnvalue">gchar</span> *
677 g_irepository_get_typelib_path (<em class="parameter"><code><a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a> *repository</code></em>,
678 <em class="parameter"><code>const <span class="type">gchar</span> *namespace_</code></em>);</pre>
679 <p>If namespace <em class="parameter"><code>namespace_</code></em>
680 is loaded, return the full path to the
681 .typelib file it was loaded from. If the typelib for
682 namespace <em class="parameter"><code>namespace_</code></em>
683 was included in a shared library, return
684 the special string "<builtin>".</p>
685 <div class="refsect3">
686 <a name="g-irepository-get-typelib-path.parameters"></a><h4>Parameters</h4>
687 <div class="informaltable"><table class="informaltable" width="100%" border="0">
689 <col width="150px" class="parameters_name">
690 <col class="parameters_description">
691 <col width="200px" class="parameters_annotations">
695 <td class="parameter_name"><p>repository</p></td>
696 <td class="parameter_description"><p> A <a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a> or <code class="literal">NULL</code> for the singleton
697 process-global default <a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a>. </p></td>
698 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
701 <td class="parameter_name"><p>namespace_</p></td>
702 <td class="parameter_description"><p>GI namespace to use, e.g. "Gtk"</p></td>
703 <td class="parameter_annotations"> </td>
708 <div class="refsect3">
709 <a name="g-irepository-get-typelib-path.returns"></a><h4>Returns</h4>
710 <p> Filesystem path (or $lt;builtin$gt;) if successful, <code class="literal">NULL</code> if namespace is not loaded</p>
714 <div class="refsect2">
715 <a name="g-irepository-is-registered"></a><h3>g_irepository_is_registered ()</h3>
716 <pre class="programlisting"><span class="returnvalue">gboolean</span>
717 g_irepository_is_registered (<em class="parameter"><code><a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a> *repository</code></em>,
718 <em class="parameter"><code>const <span class="type">gchar</span> *namespace_</code></em>,
719 <em class="parameter"><code>const <span class="type">gchar</span> *version</code></em>);</pre>
720 <p>Check whether a particular namespace (and optionally, a specific
721 version thereof) is currently loaded. This function is likely to
722 only be useful in unusual circumstances; in order to act upon
723 metadata in the namespace, you should call <a class="link" href="GIRepository.html#g-irepository-require" title="g_irepository_require ()"><code class="function">g_irepository_require()</code></a>
724 instead which will ensure the namespace is loaded, and return as
725 quickly as this function will if it has already been loaded.</p>
726 <div class="refsect3">
727 <a name="g-irepository-is-registered.parameters"></a><h4>Parameters</h4>
728 <div class="informaltable"><table class="informaltable" width="100%" border="0">
730 <col width="150px" class="parameters_name">
731 <col class="parameters_description">
732 <col width="200px" class="parameters_annotations">
736 <td class="parameter_name"><p>repository</p></td>
737 <td class="parameter_description"><p> A <a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a> or <code class="literal">NULL</code> for the singleton
738 process-global default <a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a>. </p></td>
739 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
742 <td class="parameter_name"><p>namespace_</p></td>
743 <td class="parameter_description"><p>Namespace of interest</p></td>
744 <td class="parameter_annotations"> </td>
747 <td class="parameter_name"><p>version</p></td>
748 <td class="parameter_description"><p> Required version, may be <code class="literal">NULL</code> for latest. </p></td>
749 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
754 <div class="refsect3">
755 <a name="g-irepository-is-registered.returns"></a><h4>Returns</h4>
756 <p> <code class="literal">TRUE</code> if namespace-version is loaded, <code class="literal">FALSE</code> otherwise</p>
760 <div class="refsect2">
761 <a name="g-irepository-require"></a><h3>g_irepository_require ()</h3>
762 <pre class="programlisting"><a class="link" href="gi-gitypelib.html#GITypelib" title="GITypelib"><span class="returnvalue">GITypelib</span></a> *
763 g_irepository_require (<em class="parameter"><code><a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a> *repository</code></em>,
764 <em class="parameter"><code>const <span class="type">gchar</span> *namespace_</code></em>,
765 <em class="parameter"><code>const <span class="type">gchar</span> *version</code></em>,
766 <em class="parameter"><code><a class="link" href="GIRepository.html#GIRepositoryLoadFlags" title="enum GIRepositoryLoadFlags"><span class="type">GIRepositoryLoadFlags</span></a> flags</code></em>,
767 <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
768 <p>Force the namespace <em class="parameter"><code>namespace_</code></em>
769 to be loaded if it isn't already.
770 If <em class="parameter"><code>namespace_</code></em>
771 is not loaded, this function will search for a
772 ".typelib" file using the repository search path. In addition, a
773 version <em class="parameter"><code>version</code></em>
774 of namespace may be specified. If <em class="parameter"><code>version</code></em>
776 not specified, the latest will be used.</p>
777 <div class="refsect3">
778 <a name="g-irepository-require.parameters"></a><h4>Parameters</h4>
779 <div class="informaltable"><table class="informaltable" width="100%" border="0">
781 <col width="150px" class="parameters_name">
782 <col class="parameters_description">
783 <col width="200px" class="parameters_annotations">
787 <td class="parameter_name"><p>repository</p></td>
788 <td class="parameter_description"><p> A <a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a> or <code class="literal">NULL</code> for the singleton
789 process-global default <a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a>. </p></td>
790 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
793 <td class="parameter_name"><p>namespace_</p></td>
794 <td class="parameter_description"><p>GI namespace to use, e.g. "Gtk"</p></td>
795 <td class="parameter_annotations"> </td>
798 <td class="parameter_name"><p>version</p></td>
799 <td class="parameter_description"><p> Version of namespace, may be <code class="literal">NULL</code> for latest. </p></td>
800 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
803 <td class="parameter_name"><p>flags</p></td>
804 <td class="parameter_description"><p>Set of <a class="link" href="GIRepository.html#GIRepositoryLoadFlags" title="enum GIRepositoryLoadFlags"><code class="literal">GIRepositoryLoadFlags</code></a>, may be 0</p></td>
805 <td class="parameter_annotations"> </td>
808 <td class="parameter_name"><p>error</p></td>
809 <td class="parameter_description"><p>a <span class="type">GError</span>.</p></td>
810 <td class="parameter_annotations"> </td>
815 <div class="refsect3">
816 <a name="g-irepository-require.returns"></a><h4>Returns</h4>
817 <p> a pointer to the <a class="link" href="gi-gitypelib.html#GITypelib" title="GITypelib"><span class="type">GITypelib</span></a> if successful, <code class="literal">NULL</code> otherwise. </p>
818 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
822 <div class="refsect2">
823 <a name="g-irepository-require-private"></a><h3>g_irepository_require_private ()</h3>
824 <pre class="programlisting"><a class="link" href="gi-gitypelib.html#GITypelib" title="GITypelib"><span class="returnvalue">GITypelib</span></a> *
825 g_irepository_require_private (<em class="parameter"><code><a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a> *repository</code></em>,
826 <em class="parameter"><code>const <span class="type">gchar</span> *typelib_dir</code></em>,
827 <em class="parameter"><code>const <span class="type">gchar</span> *namespace_</code></em>,
828 <em class="parameter"><code>const <span class="type">gchar</span> *version</code></em>,
829 <em class="parameter"><code><a class="link" href="GIRepository.html#GIRepositoryLoadFlags" title="enum GIRepositoryLoadFlags"><span class="type">GIRepositoryLoadFlags</span></a> flags</code></em>,
830 <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
831 <p>Force the namespace <em class="parameter"><code>namespace_</code></em>
832 to be loaded if it isn't already.
833 If <em class="parameter"><code>namespace_</code></em>
834 is not loaded, this function will search for a
835 ".typelib" file within the private directory only. In addition, a
836 version <em class="parameter"><code>version</code></em>
837 of namespace should be specified. If <em class="parameter"><code>version</code></em>
839 not specified, the latest will be used.</p>
840 <div class="refsect3">
841 <a name="g-irepository-require-private.parameters"></a><h4>Parameters</h4>
842 <div class="informaltable"><table class="informaltable" width="100%" border="0">
844 <col width="150px" class="parameters_name">
845 <col class="parameters_description">
846 <col width="200px" class="parameters_annotations">
850 <td class="parameter_name"><p>repository</p></td>
851 <td class="parameter_description"><p> A <a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a> or <code class="literal">NULL</code> for the singleton
852 process-global default <a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a>. </p></td>
853 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
856 <td class="parameter_name"><p>typelib_dir</p></td>
857 <td class="parameter_description"><p>Private directory where to find the requested typelib</p></td>
858 <td class="parameter_annotations"> </td>
861 <td class="parameter_name"><p>namespace_</p></td>
862 <td class="parameter_description"><p>GI namespace to use, e.g. "Gtk"</p></td>
863 <td class="parameter_annotations"> </td>
866 <td class="parameter_name"><p>version</p></td>
867 <td class="parameter_description"><p> Version of namespace, may be <code class="literal">NULL</code> for latest. </p></td>
868 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
871 <td class="parameter_name"><p>flags</p></td>
872 <td class="parameter_description"><p>Set of <a class="link" href="GIRepository.html#GIRepositoryLoadFlags" title="enum GIRepositoryLoadFlags"><code class="literal">GIRepositoryLoadFlags</code></a>, may be 0</p></td>
873 <td class="parameter_annotations"> </td>
876 <td class="parameter_name"><p>error</p></td>
877 <td class="parameter_description"><p>a <span class="type">GError</span>.</p></td>
878 <td class="parameter_annotations"> </td>
883 <div class="refsect3">
884 <a name="g-irepository-require-private.returns"></a><h4>Returns</h4>
885 <p> a pointer to the <a class="link" href="gi-gitypelib.html#GITypelib" title="GITypelib"><span class="type">GITypelib</span></a> if successful, <code class="literal">NULL</code> otherwise. </p>
886 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
890 <div class="refsect2">
891 <a name="g-irepository-get-c-prefix"></a><h3>g_irepository_get_c_prefix ()</h3>
892 <pre class="programlisting">const <span class="returnvalue">gchar</span> *
893 g_irepository_get_c_prefix (<em class="parameter"><code><a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a> *repository</code></em>,
894 <em class="parameter"><code>const <span class="type">gchar</span> *namespace_</code></em>);</pre>
895 <p>This function returns the "C prefix", or the C level namespace
896 associated with the given introspection namespace. Each C symbol
897 starts with this prefix, as well each <span class="type">GType</span> in the library.</p>
898 <p>Note: The namespace must have already been loaded using a function
899 such as <a class="link" href="GIRepository.html#g-irepository-require" title="g_irepository_require ()"><code class="function">g_irepository_require()</code></a> before calling this function.</p>
900 <div class="refsect3">
901 <a name="g-irepository-get-c-prefix.parameters"></a><h4>Parameters</h4>
902 <div class="informaltable"><table class="informaltable" width="100%" border="0">
904 <col width="150px" class="parameters_name">
905 <col class="parameters_description">
906 <col width="200px" class="parameters_annotations">
910 <td class="parameter_name"><p>repository</p></td>
911 <td class="parameter_description"><p> A <a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a> or <code class="literal">NULL</code> for the singleton
912 process-global default <a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a>. </p></td>
913 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
916 <td class="parameter_name"><p>namespace_</p></td>
917 <td class="parameter_description"><p>Namespace to inspect</p></td>
918 <td class="parameter_annotations"> </td>
923 <div class="refsect3">
924 <a name="g-irepository-get-c-prefix.returns"></a><h4>Returns</h4>
925 <p> C namespace prefix, or <code class="literal">NULL</code> if none associated</p>
929 <div class="refsect2">
930 <a name="g-irepository-get-shared-library"></a><h3>g_irepository_get_shared_library ()</h3>
931 <pre class="programlisting">const <span class="returnvalue">gchar</span> *
932 g_irepository_get_shared_library (<em class="parameter"><code><a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a> *repository</code></em>,
933 <em class="parameter"><code>const <span class="type">gchar</span> *namespace_</code></em>);</pre>
934 <p>This function returns a comma-separated list of paths to the
935 shared C libraries associated with the given namespace <em class="parameter"><code>namespace_</code></em>
937 There may be no shared library path associated, in which case this
938 function will return <code class="literal">NULL</code>.</p>
939 <p>Note: The namespace must have already been loaded using a function
940 such as <a class="link" href="GIRepository.html#g-irepository-require" title="g_irepository_require ()"><code class="function">g_irepository_require()</code></a> before calling this function.</p>
941 <div class="refsect3">
942 <a name="g-irepository-get-shared-library.parameters"></a><h4>Parameters</h4>
943 <div class="informaltable"><table class="informaltable" width="100%" border="0">
945 <col width="150px" class="parameters_name">
946 <col class="parameters_description">
947 <col width="200px" class="parameters_annotations">
951 <td class="parameter_name"><p>repository</p></td>
952 <td class="parameter_description"><p> A <a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a> or <code class="literal">NULL</code> for the singleton
953 process-global default <a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a>. </p></td>
954 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
957 <td class="parameter_name"><p>namespace_</p></td>
958 <td class="parameter_description"><p>Namespace to inspect</p></td>
959 <td class="parameter_annotations"> </td>
964 <div class="refsect3">
965 <a name="g-irepository-get-shared-library.returns"></a><h4>Returns</h4>
966 <p> Comma-separated list of paths to shared libraries,
967 or <code class="literal">NULL</code> if none are associated</p>
971 <div class="refsect2">
972 <a name="g-irepository-get-version"></a><h3>g_irepository_get_version ()</h3>
973 <pre class="programlisting">const <span class="returnvalue">gchar</span> *
974 g_irepository_get_version (<em class="parameter"><code><a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a> *repository</code></em>,
975 <em class="parameter"><code>const <span class="type">gchar</span> *namespace_</code></em>);</pre>
976 <p>This function returns the loaded version associated with the given
977 namespace <em class="parameter"><code>namespace_</code></em>
979 <p>Note: The namespace must have already been loaded using a function
980 such as <a class="link" href="GIRepository.html#g-irepository-require" title="g_irepository_require ()"><code class="function">g_irepository_require()</code></a> before calling this function.</p>
981 <div class="refsect3">
982 <a name="g-irepository-get-version.parameters"></a><h4>Parameters</h4>
983 <div class="informaltable"><table class="informaltable" width="100%" border="0">
985 <col width="150px" class="parameters_name">
986 <col class="parameters_description">
987 <col width="200px" class="parameters_annotations">
991 <td class="parameter_name"><p>repository</p></td>
992 <td class="parameter_description"><p> A <a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a> or <code class="literal">NULL</code> for the singleton
993 process-global default <a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a>. </p></td>
994 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
997 <td class="parameter_name"><p>namespace_</p></td>
998 <td class="parameter_description"><p>Namespace to inspect</p></td>
999 <td class="parameter_annotations"> </td>
1004 <div class="refsect3">
1005 <a name="g-irepository-get-version.returns"></a><h4>Returns</h4>
1006 <p> Loaded version</p>
1010 <div class="refsect2">
1011 <a name="g-irepository-find-by-gtype"></a><h3>g_irepository_find_by_gtype ()</h3>
1012 <pre class="programlisting"><span class="returnvalue">GIBaseInfo</span> *
1013 g_irepository_find_by_gtype (<em class="parameter"><code><a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a> *repository</code></em>,
1014 <em class="parameter"><code><span class="type">GType</span> gtype</code></em>);</pre>
1015 <p>Searches all loaded namespaces for a particular <span class="type">GType</span>. Note that
1016 in order to locate the metadata, the namespace corresponding to
1017 the type must first have been loaded. There is currently no
1018 mechanism for determining the namespace which corresponds to an
1019 arbitrary GType - thus, this function will operate most reliably
1020 when you know the GType to originate from be from a loaded namespace.</p>
1021 <div class="refsect3">
1022 <a name="g-irepository-find-by-gtype.parameters"></a><h4>Parameters</h4>
1023 <div class="informaltable"><table class="informaltable" width="100%" border="0">
1025 <col width="150px" class="parameters_name">
1026 <col class="parameters_description">
1027 <col width="200px" class="parameters_annotations">
1031 <td class="parameter_name"><p>repository</p></td>
1032 <td class="parameter_description"><p> A <a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a> or <code class="literal">NULL</code> for the singleton
1033 process-global default <a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a>. </p></td>
1034 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
1037 <td class="parameter_name"><p>gtype</p></td>
1038 <td class="parameter_description"><p>GType to search for</p></td>
1039 <td class="parameter_annotations"> </td>
1044 <div class="refsect3">
1045 <a name="g-irepository-find-by-gtype.returns"></a><h4>Returns</h4>
1046 <p> <span class="type">GIBaseInfo</span> representing metadata about <em class="parameter"><code>type</code></em>
1047 , or <code class="literal">NULL</code>. </p>
1048 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
1052 <div class="refsect2">
1053 <a name="g-irepository-find-by-error-domain"></a><h3>g_irepository_find_by_error_domain ()</h3>
1054 <pre class="programlisting"><a class="link" href="gi-GIEnumInfo.html#GIEnumInfo" title="GIEnumInfo"><span class="returnvalue">GIEnumInfo</span></a> *
1055 g_irepository_find_by_error_domain (<em class="parameter"><code><a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a> *repository</code></em>,
1056 <em class="parameter"><code><span class="type">GQuark</span> domain</code></em>);</pre>
1057 <p>Searches for the enum type corresponding to the given <span class="type">GError</span>
1058 domain. Before calling this function for a particular namespace,
1059 you must call <a class="link" href="GIRepository.html#g-irepository-require" title="g_irepository_require ()"><code class="function">g_irepository_require()</code></a> once to load the namespace, or
1060 otherwise ensure the namespace has already been loaded.</p>
1061 <div class="refsect3">
1062 <a name="g-irepository-find-by-error-domain.parameters"></a><h4>Parameters</h4>
1063 <div class="informaltable"><table class="informaltable" width="100%" border="0">
1065 <col width="150px" class="parameters_name">
1066 <col class="parameters_description">
1067 <col width="200px" class="parameters_annotations">
1071 <td class="parameter_name"><p>repository</p></td>
1072 <td class="parameter_description"><p> A <a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a> or <code class="literal">NULL</code> for the singleton
1073 process-global default <a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a>. </p></td>
1074 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
1077 <td class="parameter_name"><p>domain</p></td>
1078 <td class="parameter_description"><p>a <span class="type">GError</span> domain</p></td>
1079 <td class="parameter_annotations"> </td>
1084 <div class="refsect3">
1085 <a name="g-irepository-find-by-error-domain.returns"></a><h4>Returns</h4>
1086 <p> <a class="link" href="gi-GIEnumInfo.html#GIEnumInfo" title="GIEnumInfo"><span class="type">GIEnumInfo</span></a> representing metadata about <em class="parameter"><code>domain</code></em>
1088 enum type, or <code class="literal">NULL</code>. </p>
1089 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
1091 <p class="since">Since: <a class="link" href="api-index-1-29-17.html#api-index-1.29.17">1.29.17</a></p>
1094 <div class="refsect2">
1095 <a name="g-irepository-find-by-name"></a><h3>g_irepository_find_by_name ()</h3>
1096 <pre class="programlisting"><span class="returnvalue">GIBaseInfo</span> *
1097 g_irepository_find_by_name (<em class="parameter"><code><a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a> *repository</code></em>,
1098 <em class="parameter"><code>const <span class="type">gchar</span> *namespace_</code></em>,
1099 <em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>);</pre>
1100 <p>Searches for a particular entry in a namespace. Before calling
1101 this function for a particular namespace, you must call
1102 <a class="link" href="GIRepository.html#g-irepository-require" title="g_irepository_require ()"><code class="function">g_irepository_require()</code></a> once to load the namespace, or otherwise
1103 ensure the namespace has already been loaded.</p>
1104 <div class="refsect3">
1105 <a name="g-irepository-find-by-name.parameters"></a><h4>Parameters</h4>
1106 <div class="informaltable"><table class="informaltable" width="100%" border="0">
1108 <col width="150px" class="parameters_name">
1109 <col class="parameters_description">
1110 <col width="200px" class="parameters_annotations">
1114 <td class="parameter_name"><p>repository</p></td>
1115 <td class="parameter_description"><p> A <a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a> or <code class="literal">NULL</code> for the singleton
1116 process-global default <a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a>. </p></td>
1117 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
1120 <td class="parameter_name"><p>namespace_</p></td>
1121 <td class="parameter_description"><p>Namespace which will be searched</p></td>
1122 <td class="parameter_annotations"> </td>
1125 <td class="parameter_name"><p>name</p></td>
1126 <td class="parameter_description"><p>Entry name to find</p></td>
1127 <td class="parameter_annotations"> </td>
1132 <div class="refsect3">
1133 <a name="g-irepository-find-by-name.returns"></a><h4>Returns</h4>
1134 <p> <span class="type">GIBaseInfo</span> representing metadata about <em class="parameter"><code>name</code></em>
1135 , or <code class="literal">NULL</code>. </p>
1136 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
1140 <div class="refsect2">
1141 <a name="g-irepository-dump"></a><h3>g_irepository_dump ()</h3>
1142 <pre class="programlisting"><span class="returnvalue">gboolean</span>
1143 g_irepository_dump (<em class="parameter"><code>const <span class="type">char</span> *arg</code></em>,
1144 <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
1145 <p>Argument specified is a comma-separated pair of filenames; i.e. of
1146 the form "input.txt,output.xml". The input file should be a
1147 UTF-8 Unix-line-ending text file, with each line containing either
1148 "get-type:" followed by the name of a GType _get_type function, or
1149 "error-quark:" followed by the name of an error quark function. No
1150 extra whitespace is allowed.</p>
1151 <p>The output file should already exist, but be empty. This function will
1152 overwrite its contents.</p>
1153 <div class="refsect3">
1154 <a name="g-irepository-dump.parameters"></a><h4>Parameters</h4>
1155 <div class="informaltable"><table class="informaltable" width="100%" border="0">
1157 <col width="150px" class="parameters_name">
1158 <col class="parameters_description">
1159 <col width="200px" class="parameters_annotations">
1163 <td class="parameter_name"><p>arg</p></td>
1164 <td class="parameter_description"><p>Comma-separated pair of input and output filenames</p></td>
1165 <td class="parameter_annotations"> </td>
1168 <td class="parameter_name"><p>error</p></td>
1169 <td class="parameter_description"><p>a <code class="literal">GError</code></p></td>
1170 <td class="parameter_annotations"> </td>
1175 <div class="refsect3">
1176 <a name="g-irepository-dump.returns"></a><h4>Returns</h4>
1177 <p> <code class="literal">TRUE</code> on success, <code class="literal">FALSE</code> on error</p>
1181 <div class="refsect2">
1182 <a name="gi-cclosure-marshal-generic"></a><h3>gi_cclosure_marshal_generic ()</h3>
1183 <pre class="programlisting"><span class="returnvalue">void</span>
1184 gi_cclosure_marshal_generic (<em class="parameter"><code><span class="type">GClosure</span> *closure</code></em>,
1185 <em class="parameter"><code><span class="type">GValue</span> *return_gvalue</code></em>,
1186 <em class="parameter"><code><span class="type">guint</span> n_param_values</code></em>,
1187 <em class="parameter"><code>const <span class="type">GValue</span> *param_values</code></em>,
1188 <em class="parameter"><code><span class="type">gpointer</span> invocation_hint</code></em>,
1189 <em class="parameter"><code><span class="type">gpointer</span> marshal_data</code></em>);</pre>
1191 <div class="refsect3">
1192 <a name="gi-cclosure-marshal-generic.parameters"></a><h4>Parameters</h4>
1193 <div class="informaltable"><table class="informaltable" width="100%" border="0">
1195 <col width="150px" class="parameters_name">
1196 <col class="parameters_description">
1197 <col width="200px" class="parameters_annotations">
1201 <td class="parameter_name"><p>closure</p></td>
1202 <td class="parameter_description"><p>TODO</p></td>
1203 <td class="parameter_annotations"> </td>
1206 <td class="parameter_name"><p>return_gvalue</p></td>
1207 <td class="parameter_description"><p>TODO</p></td>
1208 <td class="parameter_annotations"> </td>
1211 <td class="parameter_name"><p>n_param_values</p></td>
1212 <td class="parameter_description"><p>TODO</p></td>
1213 <td class="parameter_annotations"> </td>
1216 <td class="parameter_name"><p>param_values</p></td>
1217 <td class="parameter_description"><p>TODO</p></td>
1218 <td class="parameter_annotations"> </td>
1221 <td class="parameter_name"><p>invocation_hint</p></td>
1222 <td class="parameter_description"><p>TODO</p></td>
1223 <td class="parameter_annotations"> </td>
1226 <td class="parameter_name"><p>marshal_data</p></td>
1227 <td class="parameter_description"><p>TODO</p></td>
1228 <td class="parameter_annotations"> </td>
1235 <div class="refsect1">
1236 <a name="GIRepository.other_details"></a><h2>Types and Values</h2>
1237 <div class="refsect2">
1238 <a name="GIRepository-struct"></a><h3>struct GIRepository</h3>
1239 <pre class="programlisting">struct GIRepository;</pre>
1240 <p>The GIRepository structure contains private data and should only be
1241 accessed using the provided API.</p>
1244 <div class="refsect2">
1245 <a name="GIRepositoryLoadFlags"></a><h3>enum GIRepositoryLoadFlags</h3>
1246 <p>Flags that control how a typelib is loaded.</p>
1247 <div class="refsect3">
1248 <a name="GIRepositoryLoadFlags.members"></a><h4>Members</h4>
1249 <div class="informaltable"><table class="informaltable" width="100%" border="0">
1251 <col width="300px" class="enum_members_name">
1252 <col class="enum_members_description">
1253 <col width="200px" class="enum_members_annotations">
1256 <td class="enum_member_name"><p><a name="G-IREPOSITORY-LOAD-FLAG-LAZY:CAPS"></a>G_IREPOSITORY_LOAD_FLAG_LAZY</p></td>
1257 <td class="enum_member_description">
1258 <p>Lazily load the typelib.</p>
1260 <td class="enum_member_annotations"> </td>
1266 <div class="refsect2">
1267 <a name="G-IREPOSITORY-ERROR:CAPS"></a><h3>G_IREPOSITORY_ERROR</h3>
1268 <pre class="programlisting">#define G_IREPOSITORY_ERROR (g_irepository_error_quark ())
1270 <p>Error domain for <a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a>. Errors in this domain will be from the
1271 <a class="link" href="GIRepository.html#GIRepositoryError" title="enum GIRepositoryError"><span class="type">GIRepositoryError</span></a> enumeration. See <span class="type">GError</span> for more information on
1275 <div class="refsect2">
1276 <a name="GIRepositoryError"></a><h3>enum GIRepositoryError</h3>
1277 <p>An error code used with <a class="link" href="GIRepository.html#G-IREPOSITORY-ERROR:CAPS" title="G_IREPOSITORY_ERROR"><span class="type">G_IREPOSITORY_ERROR</span></a> in a <span class="type">GError</span> returned
1278 from a <a class="link" href="GIRepository.html" title="GIRepository"><span class="type">GIRepository</span></a> routine.</p>
1279 <div class="refsect3">
1280 <a name="GIRepositoryError.members"></a><h4>Members</h4>
1281 <div class="informaltable"><table class="informaltable" width="100%" border="0">
1283 <col width="300px" class="enum_members_name">
1284 <col class="enum_members_description">
1285 <col width="200px" class="enum_members_annotations">
1289 <td class="enum_member_name"><p><a name="G-IREPOSITORY-ERROR-TYPELIB-NOT-FOUND:CAPS"></a>G_IREPOSITORY_ERROR_TYPELIB_NOT_FOUND</p></td>
1290 <td class="enum_member_description">
1291 <p>the typelib could not be found.</p>
1293 <td class="enum_member_annotations"> </td>
1296 <td class="enum_member_name"><p><a name="G-IREPOSITORY-ERROR-NAMESPACE-MISMATCH:CAPS"></a>G_IREPOSITORY_ERROR_NAMESPACE_MISMATCH</p></td>
1297 <td class="enum_member_description">
1298 <p>the namespace does not match the
1299 requested namespace.</p>
1301 <td class="enum_member_annotations"> </td>
1304 <td class="enum_member_name"><p><a name="G-IREPOSITORY-ERROR-NAMESPACE-VERSION-CONFLICT:CAPS"></a>G_IREPOSITORY_ERROR_NAMESPACE_VERSION_CONFLICT</p></td>
1305 <td class="enum_member_description">
1306 <p>the version of the
1307 typelib does not match the requested version.</p>
1309 <td class="enum_member_annotations"> </td>
1312 <td class="enum_member_name"><p><a name="G-IREPOSITORY-ERROR-LIBRARY-NOT-FOUND:CAPS"></a>G_IREPOSITORY_ERROR_LIBRARY_NOT_FOUND</p></td>
1313 <td class="enum_member_description">
1314 <p>the library used by the typelib
1315 could not be found.</p>
1317 <td class="enum_member_annotations"> </td>
1325 <div class="footer">
1326 <hr>Generated by GTK-Doc V1.25.1</div>