docs/reference/html/gi-girepository.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2 <html>
   3 <head>
   4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   5 <title>girepository</title>
   6 <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
   7 <link rel="home" href="index.html" title="GObject Introspection Reference Manual">
   8 <link rel="up" href="gi-libgirepository.html" title="GIRepository">
   9 <link rel="prev" href="gi-libgirepository.html" title="GIRepository">
  10 <link rel="next" href="gi-ffi.html" title="GIR Foreign functions interface">
  11 <meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
  12 <link rel="stylesheet" href="style.css" type="text/css">
  13 </head>
  14 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  15 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
  16 <tr valign="middle">
  17 <td><a accesskey="p" href="gi-libgirepository.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
  18 <td><a accesskey="u" href="gi-libgirepository.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
  19 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
  20 <th width="100%" align="center">GObject Introspection Reference Manual</th>
  21 <td><a accesskey="n" href="gi-ffi.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
  22 </tr>
  23 <tr><td colspan="5" class="shortcuts">
  24 <a href="#gi-girepository.synopsis" class="shortcut">Top</a>
  25                    |
  26                   <a href="#gi-girepository.description" class="shortcut">Description</a>
  27                    |
  28                   <a href="#gi-girepository.object-hierarchy" class="shortcut">Object Hierarchy</a>
  29 </td></tr>
  30 </table>
  31 <div class="refentry">
  32 <a name="gi-girepository"></a><div class="titlepage"></div>
  33 <div class="refnamediv"><table width="100%"><tr>
  34 <td valign="top">
  35 <h2><span class="refentrytitle"><a name="gi-girepository.top_of_page"></a>girepository</span></h2>
  36 <p>girepository</p>
  37 </td>
  38 <td valign="top" align="right"></td>
  39 </tr></table></div>
  40 <div class="refsynopsisdiv">
  41 <a name="gi-girepository.synopsis"></a><h2>Synopsis</h2>
  42 <a name="GIRepository"></a><pre class="synopsis">typedef             <a class="link" href="gi-girepository.html#GICallbackInfo" title="GICallbackInfo">GICallbackInfo</a>;
  43 struct              <a class="link" href="gi-girepository.html#GIRepository-struct" title="struct GIRepository">GIRepository</a>;
  44 enum                <a class="link" href="gi-girepository.html#GIRepositoryError" title="enum GIRepositoryError">GIRepositoryError</a>;
  45 enum                <a class="link" href="gi-girepository.html#GIRepositoryLoadFlags" title="enum GIRepositoryLoadFlags">GIRepositoryLoadFlags</a>;
  46                     <a class="link" href="gi-girepository.html#GITypelib" title="GITypelib">GITypelib</a>;
  47 <a class="link" href="gi-girepository.html#GIRepository"><span class="returnvalue">GIRepository</span></a> *      <a class="link" href="gi-girepository.html#g-irepository-get-default" title="g_irepository_get_default ()">g_irepository_get_default</a>           (<em class="parameter"><code><span class="type">void</span></code></em>);
  48 <span class="returnvalue">void</span>                <a class="link" href="gi-girepository.html#g-irepository-prepend-search-path" title="g_irepository_prepend_search_path ()">g_irepository_prepend_search_path</a>   (<em class="parameter"><code>const <span class="type">char</span> *directory</code></em>);
  49 <span class="returnvalue">GSList</span> *            <a class="link" href="gi-girepository.html#g-irepository-get-search-path" title="g_irepository_get_search_path ()">g_irepository_get_search_path</a>       (<em class="parameter"><code><span class="type">void</span></code></em>);
  50 const <span class="returnvalue">char</span> *        <a class="link" href="gi-girepository.html#g-irepository-load-typelib" title="g_irepository_load_typelib ()">g_irepository_load_typelib</a>          (<em class="parameter"><code><a class="link" href="gi-girepository.html#GIRepository"><span class="type">GIRepository</span></a> *repository</code></em>,
  51                                                          <em class="parameter"><code><a class="link" href="gi-girepository.html#GITypelib" title="GITypelib"><span class="type">GITypelib</span></a> *typelib</code></em>,
  52                                                          <em class="parameter"><code><a class="link" href="gi-girepository.html#GIRepositoryLoadFlags" title="enum GIRepositoryLoadFlags"><span class="type">GIRepositoryLoadFlags</span></a> flags</code></em>,
  53                                                          <em class="parameter"><code><span class="type">GError</span> **error</code></em>);
  54 <span class="returnvalue">gboolean</span>            <a class="link" href="gi-girepository.html#g-irepository-is-registered" title="g_irepository_is_registered ()">g_irepository_is_registered</a>         (<em class="parameter"><code><a class="link" href="gi-girepository.html#GIRepository"><span class="type">GIRepository</span></a> *repository</code></em>,
  55                                                          <em class="parameter"><code>const <span class="type">gchar</span> *namespace_</code></em>,
  56                                                          <em class="parameter"><code>const <span class="type">gchar</span> *version</code></em>);
  57 <a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="returnvalue">GIBaseInfo</span></a> *        <a class="link" href="gi-girepository.html#g-irepository-find-by-name" title="g_irepository_find_by_name ()">g_irepository_find_by_name</a>          (<em class="parameter"><code><a class="link" href="gi-girepository.html#GIRepository"><span class="type">GIRepository</span></a> *repository</code></em>,
  58                                                          <em class="parameter"><code>const <span class="type">gchar</span> *namespace_</code></em>,
  59                                                          <em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>);
  60 <a class="link" href="gi-girepository.html#GITypelib" title="GITypelib"><span class="returnvalue">GITypelib</span></a> *         <a class="link" href="gi-girepository.html#g-irepository-require" title="g_irepository_require ()">g_irepository_require</a>               (<em class="parameter"><code><a class="link" href="gi-girepository.html#GIRepository"><span class="type">GIRepository</span></a> *repository</code></em>,
  61                                                          <em class="parameter"><code>const <span class="type">gchar</span> *namespace_</code></em>,
  62                                                          <em class="parameter"><code>const <span class="type">gchar</span> *version</code></em>,
  63                                                          <em class="parameter"><code><a class="link" href="gi-girepository.html#GIRepositoryLoadFlags" title="enum GIRepositoryLoadFlags"><span class="type">GIRepositoryLoadFlags</span></a> flags</code></em>,
  64                                                          <em class="parameter"><code><span class="type">GError</span> **error</code></em>);
  65 <a class="link" href="gi-girepository.html#GITypelib" title="GITypelib"><span class="returnvalue">GITypelib</span></a> *         <a class="link" href="gi-girepository.html#g-irepository-require-private" title="g_irepository_require_private ()">g_irepository_require_private</a>       (<em class="parameter"><code><a class="link" href="gi-girepository.html#GIRepository"><span class="type">GIRepository</span></a> *repository</code></em>,
  66                                                          <em class="parameter"><code>const <span class="type">gchar</span> *typelib_dir</code></em>,
  67                                                          <em class="parameter"><code>const <span class="type">gchar</span> *namespace_</code></em>,
  68                                                          <em class="parameter"><code>const <span class="type">gchar</span> *version</code></em>,
  69                                                          <em class="parameter"><code><a class="link" href="gi-girepository.html#GIRepositoryLoadFlags" title="enum GIRepositoryLoadFlags"><span class="type">GIRepositoryLoadFlags</span></a> flags</code></em>,
  70                                                          <em class="parameter"><code><span class="type">GError</span> **error</code></em>);
  71 <span class="returnvalue">gchar</span> **            <a class="link" href="gi-girepository.html#g-irepository-get-dependencies" title="g_irepository_get_dependencies ()">g_irepository_get_dependencies</a>      (<em class="parameter"><code><a class="link" href="gi-girepository.html#GIRepository"><span class="type">GIRepository</span></a> *repository</code></em>,
  72                                                          <em class="parameter"><code>const <span class="type">gchar</span> *namespace_</code></em>);
  73 <span class="returnvalue">gchar</span> **            <a class="link" href="gi-girepository.html#g-irepository-get-loaded-namespaces" title="g_irepository_get_loaded_namespaces ()">g_irepository_get_loaded_namespaces</a> (<em class="parameter"><code><a class="link" href="gi-girepository.html#GIRepository"><span class="type">GIRepository</span></a> *repository</code></em>);
  74 <a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="returnvalue">GIBaseInfo</span></a> *        <a class="link" href="gi-girepository.html#g-irepository-find-by-gtype" title="g_irepository_find_by_gtype ()">g_irepository_find_by_gtype</a>         (<em class="parameter"><code><a class="link" href="gi-girepository.html#GIRepository"><span class="type">GIRepository</span></a> *repository</code></em>,
  75                                                          <em class="parameter"><code><span class="type">GType</span> gtype</code></em>);
  76 <span class="returnvalue">gint</span>                <a class="link" href="gi-girepository.html#g-irepository-get-n-infos" title="g_irepository_get_n_infos ()">g_irepository_get_n_infos</a>           (<em class="parameter"><code><a class="link" href="gi-girepository.html#GIRepository"><span class="type">GIRepository</span></a> *repository</code></em>,
  77                                                          <em class="parameter"><code>const <span class="type">gchar</span> *namespace_</code></em>);
  78 <a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="returnvalue">GIBaseInfo</span></a> *        <a class="link" href="gi-girepository.html#g-irepository-get-info" title="g_irepository_get_info ()">g_irepository_get_info</a>              (<em class="parameter"><code><a class="link" href="gi-girepository.html#GIRepository"><span class="type">GIRepository</span></a> *repository</code></em>,
  79                                                          <em class="parameter"><code>const <span class="type">gchar</span> *namespace_</code></em>,
  80                                                          <em class="parameter"><code><span class="type">gint</span> index</code></em>);
  81 const <span class="returnvalue">gchar</span> *       <a class="link" href="gi-girepository.html#g-irepository-get-typelib-path" title="g_irepository_get_typelib_path ()">g_irepository_get_typelib_path</a>      (<em class="parameter"><code><a class="link" href="gi-girepository.html#GIRepository"><span class="type">GIRepository</span></a> *repository</code></em>,
  82                                                          <em class="parameter"><code>const <span class="type">gchar</span> *namespace_</code></em>);
  83 const <span class="returnvalue">gchar</span> *       <a class="link" href="gi-girepository.html#g-irepository-get-shared-library" title="g_irepository_get_shared_library ()">g_irepository_get_shared_library</a>    (<em class="parameter"><code><a class="link" href="gi-girepository.html#GIRepository"><span class="type">GIRepository</span></a> *repository</code></em>,
  84                                                          <em class="parameter"><code>const <span class="type">gchar</span> *namespace_</code></em>);
  85 const <span class="returnvalue">gchar</span> *       <a class="link" href="gi-girepository.html#g-irepository-get-version" title="g_irepository_get_version ()">g_irepository_get_version</a>           (<em class="parameter"><code><a class="link" href="gi-girepository.html#GIRepository"><span class="type">GIRepository</span></a> *repository</code></em>,
  86                                                          <em class="parameter"><code>const <span class="type">gchar</span> *namespace_</code></em>);
  87 <span class="returnvalue">GOptionGroup</span> *      <a class="link" href="gi-girepository.html#g-irepository-get-option-group" title="g_irepository_get_option_group ()">g_irepository_get_option_group</a>      (<em class="parameter"><code><span class="type">void</span></code></em>);
  88 const <span class="returnvalue">gchar</span> *       <a class="link" href="gi-girepository.html#g-irepository-get-c-prefix" title="g_irepository_get_c_prefix ()">g_irepository_get_c_prefix</a>          (<em class="parameter"><code><a class="link" href="gi-girepository.html#GIRepository"><span class="type">GIRepository</span></a> *repository</code></em>,
  89                                                          <em class="parameter"><code>const <span class="type">gchar</span> *namespace_</code></em>);
  90 <span class="returnvalue">gboolean</span>            <a class="link" href="gi-girepository.html#g-irepository-dump" title="g_irepository_dump ()">g_irepository_dump</a>                  (<em class="parameter"><code>const <span class="type">char</span> *arg</code></em>,
  91                                                          <em class="parameter"><code><span class="type">GError</span> **error</code></em>);
  92 <span class="returnvalue">GList</span> *             <a class="link" href="gi-girepository.html#g-irepository-enumerate-versions" title="g_irepository_enumerate_versions ()">g_irepository_enumerate_versions</a>    (<em class="parameter"><code><a class="link" href="gi-girepository.html#GIRepository"><span class="type">GIRepository</span></a> *repository</code></em>,
  93                                                          <em class="parameter"><code>const <span class="type">gchar</span> *namespace_</code></em>);
  94 #define             <a class="link" href="gi-girepository.html#G-IREPOSITORY-ERROR:CAPS" title="G_IREPOSITORY_ERROR">G_IREPOSITORY_ERROR</a>
  95 <a class="link" href="gi-girepository.html#GITypelib" title="GITypelib"><span class="returnvalue">GITypelib</span></a> *         <a class="link" href="gi-girepository.html#g-typelib-new-from-memory" title="g_typelib_new_from_memory ()">g_typelib_new_from_memory</a>           (<em class="parameter"><code><span class="type">guint8</span> *memory</code></em>,
  96                                                          <em class="parameter"><code><span class="type">gsize</span> len</code></em>,
  97                                                          <em class="parameter"><code><span class="type">GError</span> **error</code></em>);
  98 <a class="link" href="gi-girepository.html#GITypelib" title="GITypelib"><span class="returnvalue">GITypelib</span></a> *         <a class="link" href="gi-girepository.html#g-typelib-new-from-const-memory" title="g_typelib_new_from_const_memory ()">g_typelib_new_from_const_memory</a>     (<em class="parameter"><code>const <span class="type">guint8</span> *memory</code></em>,
  99                                                          <em class="parameter"><code><span class="type">gsize</span> len</code></em>,
 100                                                          <em class="parameter"><code><span class="type">GError</span> **error</code></em>);
 101 <a class="link" href="gi-girepository.html#GITypelib" title="GITypelib"><span class="returnvalue">GITypelib</span></a> *         <a class="link" href="gi-girepository.html#g-typelib-new-from-mapped-file" title="g_typelib_new_from_mapped_file ()">g_typelib_new_from_mapped_file</a>      (<em class="parameter"><code><span class="type">GMappedFile</span> *mfile</code></em>,
 102                                                          <em class="parameter"><code><span class="type">GError</span> **error</code></em>);
 103 <span class="returnvalue">void</span>                <a class="link" href="gi-girepository.html#g-typelib-free" title="g_typelib_free ()">g_typelib_free</a>                      (<em class="parameter"><code><a class="link" href="gi-girepository.html#GITypelib" title="GITypelib"><span class="type">GITypelib</span></a> *typelib</code></em>);
 104 <span class="returnvalue">gboolean</span>            <a class="link" href="gi-girepository.html#g-typelib-symbol" title="g_typelib_symbol ()">g_typelib_symbol</a>                    (<em class="parameter"><code><a class="link" href="gi-girepository.html#GITypelib" title="GITypelib"><span class="type">GITypelib</span></a> *typelib</code></em>,
 105                                                          <em class="parameter"><code>const <span class="type">gchar</span> *symbol_name</code></em>,
 106                                                          <em class="parameter"><code><span class="type">gpointer</span> *symbol</code></em>);
 107 const <span class="returnvalue">gchar</span> *       <a class="link" href="gi-girepository.html#g-typelib-get-namespace" title="g_typelib_get_namespace ()">g_typelib_get_namespace</a>             (<em class="parameter"><code><a class="link" href="gi-girepository.html#GITypelib" title="GITypelib"><span class="type">GITypelib</span></a> *typelib</code></em>);
 108 </pre>
 109 </div>
 110 <div class="refsect1">
 111 <a name="gi-girepository.object-hierarchy"></a><h2>Object Hierarchy</h2>
 112 <pre class="synopsis">
 113   GObject
 114    +----GIRepository
 115 </pre>
 116 </div>
 117 <div class="refsect1">
 118 <a name="gi-girepository.description"></a><h2>Description</h2>
 119 </div>
 120 <div class="refsect1">
 121 <a name="gi-girepository.details"></a><h2>Details</h2>
 122 <div class="refsect2">
 123 <a name="GICallbackInfo"></a><h3>GICallbackInfo</h3>
 124 <pre class="programlisting">typedef GIBaseInfo GICallbackInfo;
 125 </pre>
 126 <p>
 127 Represents a callback, eg arguments and return value.
 128 </p>
 129 </div>
 130 <hr>
 131 <div class="refsect2">
 132 <a name="GIRepository-struct"></a><h3>struct GIRepository</h3>
 133 <pre class="programlisting">struct GIRepository;</pre>
 134 </div>
 135 <hr>
 136 <div class="refsect2">
 137 <a name="GIRepositoryError"></a><h3>enum GIRepositoryError</h3>
 138 <pre class="programlisting">typedef enum {
 139   G_IREPOSITORY_ERROR_TYPELIB_NOT_FOUND,
 140   G_IREPOSITORY_ERROR_NAMESPACE_MISMATCH,
 141   G_IREPOSITORY_ERROR_NAMESPACE_VERSION_CONFLICT,
 142   G_IREPOSITORY_ERROR_LIBRARY_NOT_FOUND
 143 } GIRepositoryError;
 144 </pre>
 145 <div class="variablelist"><table border="0">
 146 <col align="left" valign="top">
 147 <tbody>
 148 <tr>
 149 <td><p><a name="G-IREPOSITORY-ERROR-TYPELIB-NOT-FOUND:CAPS"></a><span class="term"><code class="literal">G_IREPOSITORY_ERROR_TYPELIB_NOT_FOUND</code></span></p></td>
 150 <td>the typelib could not be found.
 151 </td>
 152 </tr>
 153 <tr>
 154 <td><p><a name="G-IREPOSITORY-ERROR-NAMESPACE-MISMATCH:CAPS"></a><span class="term"><code class="literal">G_IREPOSITORY_ERROR_NAMESPACE_MISMATCH</code></span></p></td>
 155 <td>the namespace does not match the
 156 requested namespace.
 157 </td>
 158 </tr>
 159 <tr>
 160 <td><p><a name="G-IREPOSITORY-ERROR-NAMESPACE-VERSION-CONFLICT:CAPS"></a><span class="term"><code class="literal">G_IREPOSITORY_ERROR_NAMESPACE_VERSION_CONFLICT</code></span></p></td>
 161 <td>the version of the
 162 typelib does not match the requested version.
 163 </td>
 164 </tr>
 165 <tr>
 166 <td><p><a name="G-IREPOSITORY-ERROR-LIBRARY-NOT-FOUND:CAPS"></a><span class="term"><code class="literal">G_IREPOSITORY_ERROR_LIBRARY_NOT_FOUND</code></span></p></td>
 167 <td>the library used by the typelib
 168 could not be found.
 169 </td>
 170 </tr>
 171 </tbody>
 172 </table></div>
 173 </div>
 174 <hr>
 175 <div class="refsect2">
 176 <a name="GIRepositoryLoadFlags"></a><h3>enum GIRepositoryLoadFlags</h3>
 177 <pre class="programlisting">typedef enum {
 178   G_IREPOSITORY_LOAD_FLAG_LAZY = 1 &lt;&lt; 0
 179 } GIRepositoryLoadFlags;
 180 </pre>
 181 <p>
 182 Flags that controlls how a typelib is loaded by
 183 GIRepositry, used by <a class="link" href="gi-girepository.html#g-irepository-load-typelib" title="g_irepository_load_typelib ()"><code class="function">g_irepository_load_typelib()</code></a>.
 184 </p>
 185 <div class="variablelist"><table border="0">
 186 <col align="left" valign="top">
 187 <tbody><tr>
 188 <td><p><a name="G-IREPOSITORY-LOAD-FLAG-LAZY:CAPS"></a><span class="term"><code class="literal">G_IREPOSITORY_LOAD_FLAG_LAZY</code></span></p></td>
 189 <td>Load the types lazily.
 190 </td>
 191 </tr></tbody>
 192 </table></div>
 193 </div>
 194 <hr>
 195 <div class="refsect2">
 196 <a name="GITypelib"></a><h3>GITypelib</h3>
 197 <pre class="programlisting">typedef struct {
 198 } GITypelib;
 199 </pre>
 200 </div>
 201 <hr>
 202 <div class="refsect2">
 203 <a name="g-irepository-get-default"></a><h3>g_irepository_get_default ()</h3>
 204 <pre class="programlisting"><a class="link" href="gi-girepository.html#GIRepository"><span class="returnvalue">GIRepository</span></a> *      g_irepository_get_default           (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 205 <p>
 206 Returns the singleton process-global default <a class="link" href="gi-girepository.html#GIRepository"><span class="type">GIRepository</span></a>.  It is
 207 not currently supported to have multiple repositories in a
 208 particular process, but this function is provided in the unlikely
 209 eventuality that it would become possible, and as a convenience for
 210 higher level language bindings to conform to the GObject method
 211 call conventions.
 212 </p>
 213 <p>
 214 All methods on <a class="link" href="gi-girepository.html#GIRepository"><span class="type">GIRepository</span></a> also accept <a href="/src/build/jhbuild/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> as an instance
 215 parameter to mean this default repository, which is usually more
 216 convenient for C.
 217 </p>
 218 <div class="variablelist"><table border="0">
 219 <col align="left" valign="top">
 220 <tbody><tr>
 221 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 222 <td>The global singleton <a class="link" href="gi-girepository.html#GIRepository"><span class="type">GIRepository</span></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
 223 </td>
 224 </tr></tbody>
 225 </table></div>
 226 </div>
 227 <hr>
 228 <div class="refsect2">
 229 <a name="g-irepository-prepend-search-path"></a><h3>g_irepository_prepend_search_path ()</h3>
 230 <pre class="programlisting"><span class="returnvalue">void</span>                g_irepository_prepend_search_path   (<em class="parameter"><code>const <span class="type">char</span> *directory</code></em>);</pre>
 231 </div>
 232 <hr>
 233 <div class="refsect2">
 234 <a name="g-irepository-get-search-path"></a><h3>g_irepository_get_search_path ()</h3>
 235 <pre class="programlisting"><span class="returnvalue">GSList</span> *            g_irepository_get_search_path       (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 236 <p>
 237 Returns the search path the GIRepository will use when looking for typelibs.
 238 The string is internal to GIRespository and should not be freed, nor should
 239 the elements.
 240 </p>
 241 <div class="variablelist"><table border="0">
 242 <col align="left" valign="top">
 243 <tbody><tr>
 244 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 245 <td>list of strings. <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>
 246 </td>
 247 </tr></tbody>
 248 </table></div>
 249 </div>
 250 <hr>
 251 <div class="refsect2">
 252 <a name="g-irepository-load-typelib"></a><h3>g_irepository_load_typelib ()</h3>
 253 <pre class="programlisting">const <span class="returnvalue">char</span> *        g_irepository_load_typelib          (<em class="parameter"><code><a class="link" href="gi-girepository.html#GIRepository"><span class="type">GIRepository</span></a> *repository</code></em>,
 254                                                          <em class="parameter"><code><a class="link" href="gi-girepository.html#GITypelib" title="GITypelib"><span class="type">GITypelib</span></a> *typelib</code></em>,
 255                                                          <em class="parameter"><code><a class="link" href="gi-girepository.html#GIRepositoryLoadFlags" title="enum GIRepositoryLoadFlags"><span class="type">GIRepositoryLoadFlags</span></a> flags</code></em>,
 256                                                          <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
 257 </div>
 258 <hr>
 259 <div class="refsect2">
 260 <a name="g-irepository-is-registered"></a><h3>g_irepository_is_registered ()</h3>
 261 <pre class="programlisting"><span class="returnvalue">gboolean</span>            g_irepository_is_registered         (<em class="parameter"><code><a class="link" href="gi-girepository.html#GIRepository"><span class="type">GIRepository</span></a> *repository</code></em>,
 262                                                          <em class="parameter"><code>const <span class="type">gchar</span> *namespace_</code></em>,
 263                                                          <em class="parameter"><code>const <span class="type">gchar</span> *version</code></em>);</pre>
 264 <p>
 265 Check whether a particular namespace (and optionally, a specific
 266 version thereof) is currently loaded.  This function is likely to
 267 only be useful in unusual circumstances; in order to act upon
 268 metadata in the namespace, you should call <a class="link" href="gi-girepository.html#g-irepository-require" title="g_irepository_require ()"><code class="function">g_irepository_require()</code></a>
 269 instead which will ensure the namespace is loaded, and return as
 270 quickly as this function will if it has already been loaded.
 271 </p>
 272 <div class="variablelist"><table border="0">
 273 <col align="left" valign="top">
 274 <tbody>
 275 <tr>
 276 <td><p><span class="term"><em class="parameter"><code>repository</code></em> :</span></p></td>
 277 <td>A <a class="link" href="gi-girepository.html#GIRepository"><span class="type">GIRepository</span></a>, may be <a href="/src/build/jhbuild/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> for the default. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 278 </td>
 279 </tr>
 280 <tr>
 281 <td><p><span class="term"><em class="parameter"><code>namespace_</code></em> :</span></p></td>
 282 <td>Namespace of interest</td>
 283 </tr>
 284 <tr>
 285 <td><p><span class="term"><em class="parameter"><code>version</code></em> :</span></p></td>
 286 <td>Required version, may be <a href="/src/build/jhbuild/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> for latest. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 287 </td>
 288 </tr>
 289 <tr>
 290 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 291 <td>
 292 <code class="literal">TRUE</code> if namespace-version is loaded, <code class="literal">FALSE</code> otherwise</td>
 293 </tr>
 294 </tbody>
 295 </table></div>
 296 </div>
 297 <hr>
 298 <div class="refsect2">
 299 <a name="g-irepository-find-by-name"></a><h3>g_irepository_find_by_name ()</h3>
 300 <pre class="programlisting"><a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="returnvalue">GIBaseInfo</span></a> *        g_irepository_find_by_name          (<em class="parameter"><code><a class="link" href="gi-girepository.html#GIRepository"><span class="type">GIRepository</span></a> *repository</code></em>,
 301                                                          <em class="parameter"><code>const <span class="type">gchar</span> *namespace_</code></em>,
 302                                                          <em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>);</pre>
 303 <p>
 304 Searches for a particular entry in a namespace.  Before calling
 305 this function for a particular namespace, you must call
 306 <a class="link" href="gi-girepository.html#g-irepository-require" title="g_irepository_require ()"><code class="function">g_irepository_require()</code></a> once to load the namespace, or otherwise
 307 ensure the namespace has already been loaded.
 308 </p>
 309 <div class="variablelist"><table border="0">
 310 <col align="left" valign="top">
 311 <tbody>
 312 <tr>
 313 <td><p><span class="term"><em class="parameter"><code>repository</code></em> :</span></p></td>
 314 <td>A <a class="link" href="gi-girepository.html#GIRepository"><span class="type">GIRepository</span></a>, may be <a href="/src/build/jhbuild/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> for the default. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 315 </td>
 316 </tr>
 317 <tr>
 318 <td><p><span class="term"><em class="parameter"><code>namespace_</code></em> :</span></p></td>
 319 <td>Namespace which will be searched</td>
 320 </tr>
 321 <tr>
 322 <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
 323 <td>Entry name to find</td>
 324 </tr>
 325 <tr>
 326 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 327 <td>
 328 <a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="type">GIBaseInfo</span></a> representing metadata about <em class="parameter"><code>name</code></em>, or <a href="/src/build/jhbuild/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
 329 </td>
 330 </tr>
 331 </tbody>
 332 </table></div>
 333 </div>
 334 <hr>
 335 <div class="refsect2">
 336 <a name="g-irepository-require"></a><h3>g_irepository_require ()</h3>
 337 <pre class="programlisting"><a class="link" href="gi-girepository.html#GITypelib" title="GITypelib"><span class="returnvalue">GITypelib</span></a> *         g_irepository_require               (<em class="parameter"><code><a class="link" href="gi-girepository.html#GIRepository"><span class="type">GIRepository</span></a> *repository</code></em>,
 338                                                          <em class="parameter"><code>const <span class="type">gchar</span> *namespace_</code></em>,
 339                                                          <em class="parameter"><code>const <span class="type">gchar</span> *version</code></em>,
 340                                                          <em class="parameter"><code><a class="link" href="gi-girepository.html#GIRepositoryLoadFlags" title="enum GIRepositoryLoadFlags"><span class="type">GIRepositoryLoadFlags</span></a> flags</code></em>,
 341                                                          <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
 342 <p>
 343 Force the namespace <em class="parameter"><code>namespace_</code></em> to be loaded if it isn't already.
 344 If <em class="parameter"><code>namespace_</code></em> is not loaded, this function will search for a
 345 ".typelib" file using the repository search path.  In addition, a
 346 version <em class="parameter"><code>version</code></em> of namespace may be specified.  If <em class="parameter"><code>version</code></em> is
 347 not specified, the latest will be used.
 348 </p>
 349 <div class="variablelist"><table border="0">
 350 <col align="left" valign="top">
 351 <tbody>
 352 <tr>
 353 <td><p><span class="term"><em class="parameter"><code>repository</code></em> :</span></p></td>
 354 <td>Repository, may be <a href="/src/build/jhbuild/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> for the default. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 355 </td>
 356 </tr>
 357 <tr>
 358 <td><p><span class="term"><em class="parameter"><code>namespace_</code></em> :</span></p></td>
 359 <td>GI namespace to use, e.g. "Gtk"</td>
 360 </tr>
 361 <tr>
 362 <td><p><span class="term"><em class="parameter"><code>version</code></em> :</span></p></td>
 363 <td>Version of namespace, may be <a href="/src/build/jhbuild/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> for latest. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 364 </td>
 365 </tr>
 366 <tr>
 367 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
 368 <td>Set of <a class="link" href="gi-girepository.html#GIRepositoryLoadFlags" title="enum GIRepositoryLoadFlags"><code class="literal">GIRepositoryLoadFlags</code></a>, may be 0</td>
 369 </tr>
 370 <tr>
 371 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
 372 <td>a <span class="type">GError</span>.</td>
 373 </tr>
 374 <tr>
 375 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 376 <td>a pointer to the <a class="link" href="gi-girepository.html#GITypelib" title="GITypelib"><span class="type">GITypelib</span></a> if successful, <a href="/src/build/jhbuild/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> otherwise. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
 377 </td>
 378 </tr>
 379 </tbody>
 380 </table></div>
 381 </div>
 382 <hr>
 383 <div class="refsect2">
 384 <a name="g-irepository-require-private"></a><h3>g_irepository_require_private ()</h3>
 385 <pre class="programlisting"><a class="link" href="gi-girepository.html#GITypelib" title="GITypelib"><span class="returnvalue">GITypelib</span></a> *         g_irepository_require_private       (<em class="parameter"><code><a class="link" href="gi-girepository.html#GIRepository"><span class="type">GIRepository</span></a> *repository</code></em>,
 386                                                          <em class="parameter"><code>const <span class="type">gchar</span> *typelib_dir</code></em>,
 387                                                          <em class="parameter"><code>const <span class="type">gchar</span> *namespace_</code></em>,
 388                                                          <em class="parameter"><code>const <span class="type">gchar</span> *version</code></em>,
 389                                                          <em class="parameter"><code><a class="link" href="gi-girepository.html#GIRepositoryLoadFlags" title="enum GIRepositoryLoadFlags"><span class="type">GIRepositoryLoadFlags</span></a> flags</code></em>,
 390                                                          <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
 391 <p>
 392 Force the namespace <em class="parameter"><code>namespace_</code></em> to be loaded if it isn't already.
 393 If <em class="parameter"><code>namespace_</code></em> is not loaded, this function will search for a
 394 ".typelib" file within the private directory only. In addition, a
 395 version <em class="parameter"><code>version</code></em> of namespace should be specified.  If <em class="parameter"><code>version</code></em> is
 396 not specified, the latest will be used.
 397 </p>
 398 <div class="variablelist"><table border="0">
 399 <col align="left" valign="top">
 400 <tbody>
 401 <tr>
 402 <td><p><span class="term"><em class="parameter"><code>repository</code></em> :</span></p></td>
 403 <td>Repository, may be <a href="/src/build/jhbuild/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> for the default. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 404 </td>
 405 </tr>
 406 <tr>
 407 <td><p><span class="term"><em class="parameter"><code>typelib_dir</code></em> :</span></p></td>
 408 <td>Private directory where to find the requested typelib</td>
 409 </tr>
 410 <tr>
 411 <td><p><span class="term"><em class="parameter"><code>namespace_</code></em> :</span></p></td>
 412 <td>GI namespace to use, e.g. "Gtk"</td>
 413 </tr>
 414 <tr>
 415 <td><p><span class="term"><em class="parameter"><code>version</code></em> :</span></p></td>
 416 <td>Version of namespace, may be <a href="/src/build/jhbuild/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> for latest. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 417 </td>
 418 </tr>
 419 <tr>
 420 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
 421 <td>Set of <a class="link" href="gi-girepository.html#GIRepositoryLoadFlags" title="enum GIRepositoryLoadFlags"><code class="literal">GIRepositoryLoadFlags</code></a>, may be 0</td>
 422 </tr>
 423 <tr>
 424 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
 425 <td>a <span class="type">GError</span>.</td>
 426 </tr>
 427 <tr>
 428 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 429 <td>a pointer to the <a class="link" href="gi-girepository.html#GITypelib" title="GITypelib"><span class="type">GITypelib</span></a> if successful, <a href="/src/build/jhbuild/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> otherwise. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
 430 </td>
 431 </tr>
 432 </tbody>
 433 </table></div>
 434 </div>
 435 <hr>
 436 <div class="refsect2">
 437 <a name="g-irepository-get-dependencies"></a><h3>g_irepository_get_dependencies ()</h3>
 438 <pre class="programlisting"><span class="returnvalue">gchar</span> **            g_irepository_get_dependencies      (<em class="parameter"><code><a class="link" href="gi-girepository.html#GIRepository"><span class="type">GIRepository</span></a> *repository</code></em>,
 439                                                          <em class="parameter"><code>const <span class="type">gchar</span> *namespace_</code></em>);</pre>
 440 <p>
 441 Return an array of all (transitive) dependencies for namespace
 442 <em class="parameter"><code>namespace_</code></em>, including version.  The returned strings are of the
 443 form <code class="code">namespace-version</code>.
 444 </p>
 445 <p>
 446 Note: The namespace must have already been loaded using a function
 447 such as <a class="link" href="gi-girepository.html#g-irepository-require" title="g_irepository_require ()"><code class="function">g_irepository_require()</code></a> before calling this function.
 448 </p>
 449 <div class="variablelist"><table border="0">
 450 <col align="left" valign="top">
 451 <tbody>
 452 <tr>
 453 <td><p><span class="term"><em class="parameter"><code>repository</code></em> :</span></p></td>
 454 <td>A <a class="link" href="gi-girepository.html#GIRepository"><span class="type">GIRepository</span></a>, may be <a href="/src/build/jhbuild/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> for the default. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 455 </td>
 456 </tr>
 457 <tr>
 458 <td><p><span class="term"><em class="parameter"><code>namespace_</code></em> :</span></p></td>
 459 <td>Namespace of interest</td>
 460 </tr>
 461 <tr>
 462 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 463 <td>Zero-terminated string array of versioned dependencies. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
 464 </td>
 465 </tr>
 466 </tbody>
 467 </table></div>
 468 </div>
 469 <hr>
 470 <div class="refsect2">
 471 <a name="g-irepository-get-loaded-namespaces"></a><h3>g_irepository_get_loaded_namespaces ()</h3>
 472 <pre class="programlisting"><span class="returnvalue">gchar</span> **            g_irepository_get_loaded_namespaces (<em class="parameter"><code><a class="link" href="gi-girepository.html#GIRepository"><span class="type">GIRepository</span></a> *repository</code></em>);</pre>
 473 <p>
 474 Return the list of currently loaded namespaces.
 475 </p>
 476 <div class="variablelist"><table border="0">
 477 <col align="left" valign="top">
 478 <tbody>
 479 <tr>
 480 <td><p><span class="term"><em class="parameter"><code>repository</code></em> :</span></p></td>
 481 <td>A <a class="link" href="gi-girepository.html#GIRepository"><span class="type">GIRepository</span></a>, may be <a href="/src/build/jhbuild/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> for the default. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 482 </td>
 483 </tr>
 484 <tr>
 485 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 486 <td>List of namespaces. <span class="annotation">[utf8][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
 487 </td>
 488 </tr>
 489 </tbody>
 490 </table></div>
 491 </div>
 492 <hr>
 493 <div class="refsect2">
 494 <a name="g-irepository-find-by-gtype"></a><h3>g_irepository_find_by_gtype ()</h3>
 495 <pre class="programlisting"><a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="returnvalue">GIBaseInfo</span></a> *        g_irepository_find_by_gtype         (<em class="parameter"><code><a class="link" href="gi-girepository.html#GIRepository"><span class="type">GIRepository</span></a> *repository</code></em>,
 496                                                          <em class="parameter"><code><span class="type">GType</span> gtype</code></em>);</pre>
 497 <p>
 498 Searches all loaded namespaces for a particular <span class="type">GType</span>.  Note that
 499 in order to locate the metadata, the namespace corresponding to
 500 the type must first have been loaded.  There is currently no
 501 mechanism for determining the namespace which corresponds to an
 502 arbitrary GType - thus, this function will operate most reliably
 503 when you know the GType to originate from be from a loaded namespace.
 504 </p>
 505 <div class="variablelist"><table border="0">
 506 <col align="left" valign="top">
 507 <tbody>
 508 <tr>
 509 <td><p><span class="term"><em class="parameter"><code>repository</code></em> :</span></p></td>
 510 <td>A <a class="link" href="gi-girepository.html#GIRepository"><span class="type">GIRepository</span></a>, may be <a href="/src/build/jhbuild/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> for the default. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 511 </td>
 512 </tr>
 513 <tr>
 514 <td><p><span class="term"><em class="parameter"><code>gtype</code></em> :</span></p></td>
 515 <td>GType to search for</td>
 516 </tr>
 517 <tr>
 518 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 519 <td>
 520 <a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="type">GIBaseInfo</span></a> representing metadata about <em class="parameter"><code>type</code></em>, or <a href="/src/build/jhbuild/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
 521 </td>
 522 </tr>
 523 </tbody>
 524 </table></div>
 525 </div>
 526 <hr>
 527 <div class="refsect2">
 528 <a name="g-irepository-get-n-infos"></a><h3>g_irepository_get_n_infos ()</h3>
 529 <pre class="programlisting"><span class="returnvalue">gint</span>                g_irepository_get_n_infos           (<em class="parameter"><code><a class="link" href="gi-girepository.html#GIRepository"><span class="type">GIRepository</span></a> *repository</code></em>,
 530                                                          <em class="parameter"><code>const <span class="type">gchar</span> *namespace_</code></em>);</pre>
 531 <p>
 532 This function returns the number of metadata entries in
 533 given namespace <em class="parameter"><code>namespace_</code></em>.  The namespace must have
 534 already been loaded before calling this function.
 535 </p>
 536 <div class="variablelist"><table border="0">
 537 <col align="left" valign="top">
 538 <tbody>
 539 <tr>
 540 <td><p><span class="term"><em class="parameter"><code>repository</code></em> :</span></p></td>
 541 <td>A <a class="link" href="gi-girepository.html#GIRepository"><span class="type">GIRepository</span></a>, may be <a href="/src/build/jhbuild/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> for the default. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 542 </td>
 543 </tr>
 544 <tr>
 545 <td><p><span class="term"><em class="parameter"><code>namespace_</code></em> :</span></p></td>
 546 <td>Namespace to inspect</td>
 547 </tr>
 548 <tr>
 549 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 550 <td>number of metadata entries</td>
 551 </tr>
 552 </tbody>
 553 </table></div>
 554 </div>
 555 <hr>
 556 <div class="refsect2">
 557 <a name="g-irepository-get-info"></a><h3>g_irepository_get_info ()</h3>
 558 <pre class="programlisting"><a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="returnvalue">GIBaseInfo</span></a> *        g_irepository_get_info              (<em class="parameter"><code><a class="link" href="gi-girepository.html#GIRepository"><span class="type">GIRepository</span></a> *repository</code></em>,
 559                                                          <em class="parameter"><code>const <span class="type">gchar</span> *namespace_</code></em>,
 560                                                          <em class="parameter"><code><span class="type">gint</span> index</code></em>);</pre>
 561 <p>
 562 This function returns a particular metadata entry in the
 563 given namespace <em class="parameter"><code>namespace_</code></em>.  The namespace must have
 564 already been loaded before calling this function.
 565 See <a class="link" href="gi-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
 566 entries.
 567 </p>
 568 <div class="variablelist"><table border="0">
 569 <col align="left" valign="top">
 570 <tbody>
 571 <tr>
 572 <td><p><span class="term"><em class="parameter"><code>repository</code></em> :</span></p></td>
 573 <td>A <a class="link" href="gi-girepository.html#GIRepository"><span class="type">GIRepository</span></a>, may be <a href="/src/build/jhbuild/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> for the default. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 574 </td>
 575 </tr>
 576 <tr>
 577 <td><p><span class="term"><em class="parameter"><code>namespace_</code></em> :</span></p></td>
 578 <td>Namespace to inspect</td>
 579 </tr>
 580 <tr>
 581 <td><p><span class="term"><em class="parameter"><code>index</code></em> :</span></p></td>
 582 <td>0-based offset into namespace metadata for entry</td>
 583 </tr>
 584 <tr>
 585 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 586 <td>
 587 <a class="link" href="gi-GIBaseInfo.html#GIBaseInfo" title="GIBaseInfo"><span class="type">GIBaseInfo</span></a> containing metadata. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
 588 </td>
 589 </tr>
 590 </tbody>
 591 </table></div>
 592 </div>
 593 <hr>
 594 <div class="refsect2">
 595 <a name="g-irepository-get-typelib-path"></a><h3>g_irepository_get_typelib_path ()</h3>
 596 <pre class="programlisting">const <span class="returnvalue">gchar</span> *       g_irepository_get_typelib_path      (<em class="parameter"><code><a class="link" href="gi-girepository.html#GIRepository"><span class="type">GIRepository</span></a> *repository</code></em>,
 597                                                          <em class="parameter"><code>const <span class="type">gchar</span> *namespace_</code></em>);</pre>
 598 <p>
 599 If namespace <em class="parameter"><code>namespace_</code></em> is loaded, return the full path to the
 600 .typelib file it was loaded from.  If the typelib for
 601 namespace <em class="parameter"><code>namespace_</code></em> was included in a shared library, return
 602 the special string "$lt;builtin$gt;".
 603 </p>
 604 <div class="variablelist"><table border="0">
 605 <col align="left" valign="top">
 606 <tbody>
 607 <tr>
 608 <td><p><span class="term"><em class="parameter"><code>repository</code></em> :</span></p></td>
 609 <td>Repository, may be <a href="/src/build/jhbuild/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> for the default. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 610 </td>
 611 </tr>
 612 <tr>
 613 <td><p><span class="term"><em class="parameter"><code>namespace_</code></em> :</span></p></td>
 614 <td>GI namespace to use, e.g. "Gtk"</td>
 615 </tr>
 616 <tr>
 617 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 618 <td>Filesystem path (or $lt;builtin$gt;) if successful, <a href="/src/build/jhbuild/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> if namespace is not loaded</td>
 619 </tr>
 620 </tbody>
 621 </table></div>
 622 </div>
 623 <hr>
 624 <div class="refsect2">
 625 <a name="g-irepository-get-shared-library"></a><h3>g_irepository_get_shared_library ()</h3>
 626 <pre class="programlisting">const <span class="returnvalue">gchar</span> *       g_irepository_get_shared_library    (<em class="parameter"><code><a class="link" href="gi-girepository.html#GIRepository"><span class="type">GIRepository</span></a> *repository</code></em>,
 627                                                          <em class="parameter"><code>const <span class="type">gchar</span> *namespace_</code></em>);</pre>
 628 <p>
 629 This function returns the full path to the shared C library
 630 associated with the given namespace <em class="parameter"><code>namespace_</code></em>. There may be no
 631 shared library path associated, in which case this function will
 632 return <a href="/src/build/jhbuild/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>.
 633 </p>
 634 <p>
 635 Note: The namespace must have already been loaded using a function
 636 such as <a class="link" href="gi-girepository.html#g-irepository-require" title="g_irepository_require ()"><code class="function">g_irepository_require()</code></a> before calling this function.
 637 </p>
 638 <div class="variablelist"><table border="0">
 639 <col align="left" valign="top">
 640 <tbody>
 641 <tr>
 642 <td><p><span class="term"><em class="parameter"><code>repository</code></em> :</span></p></td>
 643 <td>A <a class="link" href="gi-girepository.html#GIRepository"><span class="type">GIRepository</span></a>, may be <a href="/src/build/jhbuild/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> for the default. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 644 </td>
 645 </tr>
 646 <tr>
 647 <td><p><span class="term"><em class="parameter"><code>namespace_</code></em> :</span></p></td>
 648 <td>Namespace to inspect</td>
 649 </tr>
 650 <tr>
 651 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 652 <td>Full path to shared library, or <a href="/src/build/jhbuild/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> if none associated</td>
 653 </tr>
 654 </tbody>
 655 </table></div>
 656 </div>
 657 <hr>
 658 <div class="refsect2">
 659 <a name="g-irepository-get-version"></a><h3>g_irepository_get_version ()</h3>
 660 <pre class="programlisting">const <span class="returnvalue">gchar</span> *       g_irepository_get_version           (<em class="parameter"><code><a class="link" href="gi-girepository.html#GIRepository"><span class="type">GIRepository</span></a> *repository</code></em>,
 661                                                          <em class="parameter"><code>const <span class="type">gchar</span> *namespace_</code></em>);</pre>
 662 <p>
 663 This function returns the loaded version associated with the given
 664 namespace <em class="parameter"><code>namespace_</code></em>.
 665 </p>
 666 <p>
 667 Note: The namespace must have already been loaded using a function
 668 such as <a class="link" href="gi-girepository.html#g-irepository-require" title="g_irepository_require ()"><code class="function">g_irepository_require()</code></a> before calling this function.
 669 </p>
 670 <div class="variablelist"><table border="0">
 671 <col align="left" valign="top">
 672 <tbody>
 673 <tr>
 674 <td><p><span class="term"><em class="parameter"><code>repository</code></em> :</span></p></td>
 675 <td>A <a class="link" href="gi-girepository.html#GIRepository"><span class="type">GIRepository</span></a>, may be <a href="/src/build/jhbuild/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> for the default. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 676 </td>
 677 </tr>
 678 <tr>
 679 <td><p><span class="term"><em class="parameter"><code>namespace_</code></em> :</span></p></td>
 680 <td>Namespace to inspect</td>
 681 </tr>
 682 <tr>
 683 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 684 <td>Loaded version</td>
 685 </tr>
 686 </tbody>
 687 </table></div>
 688 </div>
 689 <hr>
 690 <div class="refsect2">
 691 <a name="g-irepository-get-option-group"></a><h3>g_irepository_get_option_group ()</h3>
 692 <pre class="programlisting"><span class="returnvalue">GOptionGroup</span> *      g_irepository_get_option_group      (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 693 <p>
 694 Obtain the option group for girepository, it's used
 695 by the dumper and for programs that wants to provide
 696 introspection information
 697 </p>
 698 <div class="variablelist"><table border="0">
 699 <col align="left" valign="top">
 700 <tbody><tr>
 701 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 702 <td>the option group. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
 703 </td>
 704 </tr></tbody>
 705 </table></div>
 706 </div>
 707 <hr>
 708 <div class="refsect2">
 709 <a name="g-irepository-get-c-prefix"></a><h3>g_irepository_get_c_prefix ()</h3>
 710 <pre class="programlisting">const <span class="returnvalue">gchar</span> *       g_irepository_get_c_prefix          (<em class="parameter"><code><a class="link" href="gi-girepository.html#GIRepository"><span class="type">GIRepository</span></a> *repository</code></em>,
 711                                                          <em class="parameter"><code>const <span class="type">gchar</span> *namespace_</code></em>);</pre>
 712 <p>
 713 This function returns the "C prefix", or the C level namespace
 714 associated with the given introspection namespace.  Each C symbol
 715 starts with this prefix, as well each <span class="type">GType</span> in the library.
 716 </p>
 717 <p>
 718 Note: The namespace must have already been loaded using a function
 719 such as <a class="link" href="gi-girepository.html#g-irepository-require" title="g_irepository_require ()"><code class="function">g_irepository_require()</code></a> before calling this function.
 720 </p>
 721 <div class="variablelist"><table border="0">
 722 <col align="left" valign="top">
 723 <tbody>
 724 <tr>
 725 <td><p><span class="term"><em class="parameter"><code>repository</code></em> :</span></p></td>
 726 <td>A <a class="link" href="gi-girepository.html#GIRepository"><span class="type">GIRepository</span></a>, may be <a href="/src/build/jhbuild/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> for the default. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 727 </td>
 728 </tr>
 729 <tr>
 730 <td><p><span class="term"><em class="parameter"><code>namespace_</code></em> :</span></p></td>
 731 <td>Namespace to inspect</td>
 732 </tr>
 733 <tr>
 734 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 735 <td>C namespace prefix, or <a href="/src/build/jhbuild/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> if none associated</td>
 736 </tr>
 737 </tbody>
 738 </table></div>
 739 </div>
 740 <hr>
 741 <div class="refsect2">
 742 <a name="g-irepository-dump"></a><h3>g_irepository_dump ()</h3>
 743 <pre class="programlisting"><span class="returnvalue">gboolean</span>            g_irepository_dump                  (<em class="parameter"><code>const <span class="type">char</span> *arg</code></em>,
 744                                                          <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
 745 <p>
 746 Argument specified is a comma-separated pair of filenames; i.e. of
 747 the form "input.txt,output.xml".  The input file should be a
 748 UTF-8 Unix-line-ending text file, with each line containing the name
 749 of a GType _get_type function.
 750 </p>
 751 <p>
 752 The output file should already exist, but be empty.  This function will
 753 overwrite its contents.
 754 </p>
 755 <div class="variablelist"><table border="0">
 756 <col align="left" valign="top">
 757 <tbody>
 758 <tr>
 759 <td><p><span class="term"><em class="parameter"><code>arg</code></em> :</span></p></td>
 760 <td>Comma-separated pair of input and output filenames</td>
 761 </tr>
 762 <tr>
 763 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
 764 <td>a <code class="literal">GError</code>
 765 </td>
 766 </tr>
 767 <tr>
 768 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 769 <td>
 770 <code class="literal">TRUE</code> on success, <code class="literal">FALSE</code> on error</td>
 771 </tr>
 772 </tbody>
 773 </table></div>
 774 </div>
 775 <hr>
 776 <div class="refsect2">
 777 <a name="g-irepository-enumerate-versions"></a><h3>g_irepository_enumerate_versions ()</h3>
 778 <pre class="programlisting"><span class="returnvalue">GList</span> *             g_irepository_enumerate_versions    (<em class="parameter"><code><a class="link" href="gi-girepository.html#GIRepository"><span class="type">GIRepository</span></a> *repository</code></em>,
 779                                                          <em class="parameter"><code>const <span class="type">gchar</span> *namespace_</code></em>);</pre>
 780 <p>
 781 Obtain an unordered list of versions (either currently loaded or
 782 available) for <em class="parameter"><code>namespace_</code></em> in this <em class="parameter"><code>repository</code></em>.
 783 </p>
 784 <div class="variablelist"><table border="0">
 785 <col align="left" valign="top">
 786 <tbody>
 787 <tr>
 788 <td><p><span class="term"><em class="parameter"><code>repository</code></em> :</span></p></td>
 789 <td>the repository. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 790 </td>
 791 </tr>
 792 <tr>
 793 <td><p><span class="term"><em class="parameter"><code>namespace_</code></em> :</span></p></td>
 794 <td>GI namespace, e.g. "Gtk"</td>
 795 </tr>
 796 <tr>
 797 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 798 <td>the array of versions. <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>
 799 </td>
 800 </tr>
 801 </tbody>
 802 </table></div>
 803 </div>
 804 <hr>
 805 <div class="refsect2">
 806 <a name="G-IREPOSITORY-ERROR:CAPS"></a><h3>G_IREPOSITORY_ERROR</h3>
 807 <pre class="programlisting">#define G_IREPOSITORY_ERROR (g_irepository_error_quark ())
 808 </pre>
 809 </div>
 810 <hr>
 811 <div class="refsect2">
 812 <a name="g-typelib-new-from-memory"></a><h3>g_typelib_new_from_memory ()</h3>
 813 <pre class="programlisting"><a class="link" href="gi-girepository.html#GITypelib" title="GITypelib"><span class="returnvalue">GITypelib</span></a> *         g_typelib_new_from_memory           (<em class="parameter"><code><span class="type">guint8</span> *memory</code></em>,
 814                                                          <em class="parameter"><code><span class="type">gsize</span> len</code></em>,
 815                                                          <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
 816 <p>
 817 Creates a new <a class="link" href="gi-girepository.html#GITypelib" title="GITypelib"><span class="type">GITypelib</span></a> from a memory location.  The memory block
 818 pointed to by <em class="parameter"><code>typelib</code></em> will be automatically <code class="function">g_free()</code>d when the
 819 repository is destroyed.
 820 </p>
 821 <div class="variablelist"><table border="0">
 822 <col align="left" valign="top">
 823 <tbody>
 824 <tr>
 825 <td><p><span class="term"><em class="parameter"><code>memory</code></em> :</span></p></td>
 826 <td>address of memory chunk containing the typelib</td>
 827 </tr>
 828 <tr>
 829 <td><p><span class="term"><em class="parameter"><code>len</code></em> :</span></p></td>
 830 <td>length of memory chunk containing the typelib</td>
 831 </tr>
 832 <tr>
 833 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
 834 <td>a <span class="type">GError</span>
 835 </td>
 836 </tr>
 837 <tr>
 838 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 839 <td>the new <a class="link" href="gi-girepository.html#GITypelib" title="GITypelib"><span class="type">GITypelib</span></a>
 840 </td>
 841 </tr>
 842 </tbody>
 843 </table></div>
 844 </div>
 845 <hr>
 846 <div class="refsect2">
 847 <a name="g-typelib-new-from-const-memory"></a><h3>g_typelib_new_from_const_memory ()</h3>
 848 <pre class="programlisting"><a class="link" href="gi-girepository.html#GITypelib" title="GITypelib"><span class="returnvalue">GITypelib</span></a> *         g_typelib_new_from_const_memory     (<em class="parameter"><code>const <span class="type">guint8</span> *memory</code></em>,
 849                                                          <em class="parameter"><code><span class="type">gsize</span> len</code></em>,
 850                                                          <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
 851 <p>
 852 Creates a new <a class="link" href="gi-girepository.html#GITypelib" title="GITypelib"><span class="type">GITypelib</span></a> from a memory location.
 853 </p>
 854 <div class="variablelist"><table border="0">
 855 <col align="left" valign="top">
 856 <tbody>
 857 <tr>
 858 <td><p><span class="term"><em class="parameter"><code>memory</code></em> :</span></p></td>
 859 <td>address of memory chunk containing the typelib</td>
 860 </tr>
 861 <tr>
 862 <td><p><span class="term"><em class="parameter"><code>len</code></em> :</span></p></td>
 863 <td>length of memory chunk containing the typelib</td>
 864 </tr>
 865 <tr>
 866 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
 867 <td>A <span class="type">GError</span>
 868 </td>
 869 </tr>
 870 <tr>
 871 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 872 <td>the new <a class="link" href="gi-girepository.html#GITypelib" title="GITypelib"><span class="type">GITypelib</span></a>
 873 </td>
 874 </tr>
 875 </tbody>
 876 </table></div>
 877 </div>
 878 <hr>
 879 <div class="refsect2">
 880 <a name="g-typelib-new-from-mapped-file"></a><h3>g_typelib_new_from_mapped_file ()</h3>
 881 <pre class="programlisting"><a class="link" href="gi-girepository.html#GITypelib" title="GITypelib"><span class="returnvalue">GITypelib</span></a> *         g_typelib_new_from_mapped_file      (<em class="parameter"><code><span class="type">GMappedFile</span> *mfile</code></em>,
 882                                                          <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
 883 <p>
 884 Creates a new <a class="link" href="gi-girepository.html#GITypelib" title="GITypelib"><span class="type">GITypelib</span></a> from a <span class="type">GMappedFile</span>.
 885 </p>
 886 <div class="variablelist"><table border="0">
 887 <col align="left" valign="top">
 888 <tbody>
 889 <tr>
 890 <td><p><span class="term"><em class="parameter"><code>mfile</code></em> :</span></p></td>
 891 <td>a <span class="type">GMappedFile</span>, that will be free'd when the repository is destroyed</td>
 892 </tr>
 893 <tr>
 894 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
 895 <td>a <span class="type">GError</span>
 896 </td>
 897 </tr>
 898 <tr>
 899 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 900 <td>the new <a class="link" href="gi-girepository.html#GITypelib" title="GITypelib"><span class="type">GITypelib</span></a>
 901 </td>
 902 </tr>
 903 </tbody>
 904 </table></div>
 905 </div>
 906 <hr>
 907 <div class="refsect2">
 908 <a name="g-typelib-free"></a><h3>g_typelib_free ()</h3>
 909 <pre class="programlisting"><span class="returnvalue">void</span>                g_typelib_free                      (<em class="parameter"><code><a class="link" href="gi-girepository.html#GITypelib" title="GITypelib"><span class="type">GITypelib</span></a> *typelib</code></em>);</pre>
 910 <p>
 911 Free a <a class="link" href="gi-girepository.html#GITypelib" title="GITypelib"><span class="type">GITypelib</span></a>.
 912 </p>
 913 <div class="variablelist"><table border="0">
 914 <col align="left" valign="top">
 915 <tbody><tr>
 916 <td><p><span class="term"><em class="parameter"><code>typelib</code></em> :</span></p></td>
 917 <td>a <a class="link" href="gi-girepository.html#GITypelib" title="GITypelib"><span class="type">GITypelib</span></a>
 918 </td>
 919 </tr></tbody>
 920 </table></div>
 921 </div>
 922 <hr>
 923 <div class="refsect2">
 924 <a name="g-typelib-symbol"></a><h3>g_typelib_symbol ()</h3>
 925 <pre class="programlisting"><span class="returnvalue">gboolean</span>            g_typelib_symbol                    (<em class="parameter"><code><a class="link" href="gi-girepository.html#GITypelib" title="GITypelib"><span class="type">GITypelib</span></a> *typelib</code></em>,
 926                                                          <em class="parameter"><code>const <span class="type">gchar</span> *symbol_name</code></em>,
 927                                                          <em class="parameter"><code><span class="type">gpointer</span> *symbol</code></em>);</pre>
 928 <p>
 929 Loads a symbol from <a class="link" href="gi-girepository.html#GITypelib" title="GITypelib"><span class="type">GITypelib</span></a>.
 930 </p>
 931 <div class="variablelist"><table border="0">
 932 <col align="left" valign="top">
 933 <tbody>
 934 <tr>
 935 <td><p><span class="term"><em class="parameter"><code>typelib</code></em> :</span></p></td>
 936 <td>the typelib</td>
 937 </tr>
 938 <tr>
 939 <td><p><span class="term"><em class="parameter"><code>symbol_name</code></em> :</span></p></td>
 940 <td>name of symbol to be loaded</td>
 941 </tr>
 942 <tr>
 943 <td><p><span class="term"><em class="parameter"><code>symbol</code></em> :</span></p></td>
 944 <td>returns a pointer to the symbol value</td>
 945 </tr>
 946 <tr>
 947 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 948 <td>
 949 <span class="type">TRUE</span> on success</td>
 950 </tr>
 951 </tbody>
 952 </table></div>
 953 </div>
 954 <hr>
 955 <div class="refsect2">
 956 <a name="g-typelib-get-namespace"></a><h3>g_typelib_get_namespace ()</h3>
 957 <pre class="programlisting">const <span class="returnvalue">gchar</span> *       g_typelib_get_namespace             (<em class="parameter"><code><a class="link" href="gi-girepository.html#GITypelib" title="GITypelib"><span class="type">GITypelib</span></a> *typelib</code></em>);</pre>
 958 </div>
 959 </div>
 960 </div>
 961 <div class="footer">
 962 <hr>
 963           Generated by GTK-Doc V1.18.1</div>
 964 </body>
 965 </html>