40
40
<pre class="synopsis">
41
41
#include <gio/gio.h>
43
<a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="gio-D-Bus-Utilities.html#g-dbus-generate-guid" title="g_dbus_generate_guid ()">g_dbus_generate_guid</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
44
<a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gio-D-Bus-Utilities.html#g-dbus-is-guid" title="g_dbus_is_guid ()">g_dbus_is_guid</a> (<em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *string</code></em>);
45
<a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gio-D-Bus-Utilities.html#g-dbus-is-name" title="g_dbus_is_name ()">g_dbus_is_name</a> (<em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *string</code></em>);
46
<a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gio-D-Bus-Utilities.html#g-dbus-is-unique-name" title="g_dbus_is_unique_name ()">g_dbus_is_unique_name</a> (<em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *string</code></em>);
47
<a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gio-D-Bus-Utilities.html#g-dbus-is-member-name" title="g_dbus_is_member_name ()">g_dbus_is_member_name</a> (<em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *string</code></em>);
48
<a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gio-D-Bus-Utilities.html#g-dbus-is-interface-name" title="g_dbus_is_interface_name ()">g_dbus_is_interface_name</a> (<em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *string</code></em>);
49
<a href="./../glib/glib/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> * <a class="link" href="gio-D-Bus-Utilities.html#g-dbus-gvalue-to-gvariant" title="g_dbus_gvalue_to_gvariant ()">g_dbus_gvalue_to_gvariant</a> (<em class="parameter"><code>const <a href="./../gobject/gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *gvalue</code></em>,
50
<em class="parameter"><code>const <a href="./../glib/glib/glib-GVariantType.html#GVariantType"><span class="type">GVariantType</span></a> *type</code></em>);
51
<span class="returnvalue">void</span> <a class="link" href="gio-D-Bus-Utilities.html#g-dbus-gvariant-to-gvalue" title="g_dbus_gvariant_to_gvalue ()">g_dbus_gvariant_to_gvalue</a> (<em class="parameter"><code><a href="./../glib/glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *value</code></em>,
52
<em class="parameter"><code><a href="./../gobject/gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *out_gvalue</code></em>);
43
<a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="gio-D-Bus-Utilities.html#g-dbus-generate-guid" title="g_dbus_generate_guid ()">g_dbus_generate_guid</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
44
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gio-D-Bus-Utilities.html#g-dbus-is-guid" title="g_dbus_is_guid ()">g_dbus_is_guid</a> (<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *string</code></em>);
45
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gio-D-Bus-Utilities.html#g-dbus-is-name" title="g_dbus_is_name ()">g_dbus_is_name</a> (<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *string</code></em>);
46
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gio-D-Bus-Utilities.html#g-dbus-is-unique-name" title="g_dbus_is_unique_name ()">g_dbus_is_unique_name</a> (<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *string</code></em>);
47
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gio-D-Bus-Utilities.html#g-dbus-is-member-name" title="g_dbus_is_member_name ()">g_dbus_is_member_name</a> (<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *string</code></em>);
48
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gio-D-Bus-Utilities.html#g-dbus-is-interface-name" title="g_dbus_is_interface_name ()">g_dbus_is_interface_name</a> (<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *string</code></em>);
49
<a href="../glib/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> * <a class="link" href="gio-D-Bus-Utilities.html#g-dbus-gvalue-to-gvariant" title="g_dbus_gvalue_to_gvariant ()">g_dbus_gvalue_to_gvariant</a> (<em class="parameter"><code>const <a href="../gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *gvalue</code></em>,
50
<em class="parameter"><code>const <a href="../glib/glib-GVariantType.html#GVariantType"><span class="type">GVariantType</span></a> *type</code></em>);
51
<span class="returnvalue">void</span> <a class="link" href="gio-D-Bus-Utilities.html#g-dbus-gvariant-to-gvalue" title="g_dbus_gvariant_to_gvalue ()">g_dbus_gvariant_to_gvalue</a> (<em class="parameter"><code><a href="../glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *value</code></em>,
52
<em class="parameter"><code><a href="../gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *out_gvalue</code></em>);
55
55
<div class="refsect1">
221
221
<div class="refsect2">
222
222
<a name="g-dbus-gvalue-to-gvariant"></a><h3>g_dbus_gvalue_to_gvariant ()</h3>
223
<pre class="programlisting"><a href="./../glib/glib/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> * g_dbus_gvalue_to_gvariant (<em class="parameter"><code>const <a href="./../gobject/gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *gvalue</code></em>,
224
<em class="parameter"><code>const <a href="./../glib/glib/glib-GVariantType.html#GVariantType"><span class="type">GVariantType</span></a> *type</code></em>);</pre>
223
<pre class="programlisting"><a href="../glib/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> * g_dbus_gvalue_to_gvariant (<em class="parameter"><code>const <a href="../gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *gvalue</code></em>,
224
<em class="parameter"><code>const <a href="../glib/glib-GVariantType.html#GVariantType"><span class="type">GVariantType</span></a> *type</code></em>);</pre>
226
Converts a <a href="./../gobject/gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to a <a href="./../glib/glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> of the type indicated by the <em class="parameter"><code>type</code></em> parameter.
226
Converts a <a href="../gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to a <a href="../glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> of the type indicated by the <em class="parameter"><code>type</code></em> parameter.
229
229
The conversion is using the following rules:
231
231
<div class="table">
232
<a name="id744455"></a><p class="title"><b>Table 4. <a href="./../gobject/gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> / <a href="./../glib/glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> conversion rules</b></p>
232
<a name="id-1.4.16.2.5.8.5.1"></a><p class="title"><b>Table 4. <a href="../gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> / <a href="../glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> conversion rules</b></p>
233
233
<div class="table-contents"><table summary="GValue / GVariant conversion rules" border="1">
239
<th align="left">If the <a href="./../gobject/gobject/gobject-Type-Information.html#GType"><span class="type">GType</span></a> for <em class="parameter"><code>gvalue</code></em> is...</th>
239
<th align="left">If the <a href="../gobject/gobject-Type-Information.html#GType"><span class="type">GType</span></a> for <em class="parameter"><code>gvalue</code></em> is...</th>
240
240
<th align="left">... then <em class="parameter"><code>type</code></em> must be</th>
244
<td align="left"><a href="./../gobject/gobject/gobject-Type-Information.html#G-TYPE-STRING:CAPS"><span class="type">G_TYPE_STRING</span></a></td>
246
<a href="./../glib/glib/glib-GVariantType.html#G-VARIANT-TYPE-STRING:CAPS">'s'</a>, <a href="./../glib/glib/glib-GVariantType.html#G-VARIANT-TYPE-OBJECT-PATH:CAPS">'o'</a>, <a href="./../glib/glib/glib-GVariantType.html#G-VARIANT-TYPE-SIGNATURE:CAPS">'g'</a> or <a href="./../glib/glib/glib-GVariantType.html#G-VARIANT-TYPE-BYTESTRING:CAPS">'ay'</a>
250
<td align="left"><a href="./../gobject/gobject/gobject-Boxed-Types.html#G-TYPE-STRV:CAPS"><span class="type">G_TYPE_STRV</span></a></td>
252
<a href="./../glib/glib/glib-GVariantType.html#G-VARIANT-TYPE-STRING-ARRAY:CAPS">'as'</a>, <a href="./../glib/glib/glib-GVariantType.html#G-VARIANT-TYPE-OBJECT-PATH-ARRAY:CAPS">'ao'</a> or <a href="./../glib/glib/glib-GVariantType.html#G-VARIANT-TYPE-BYTESTRING-ARRAY:CAPS">'aay'</a>
256
<td align="left"><a href="./../gobject/gobject/gobject-Type-Information.html#G-TYPE-BOOLEAN:CAPS"><span class="type">G_TYPE_BOOLEAN</span></a></td>
257
<td align="left"><a href="./../glib/glib/glib-GVariantType.html#G-VARIANT-TYPE-BOOLEAN:CAPS">'b'</a></td>
260
<td align="left"><a href="./../gobject/gobject/gobject-Type-Information.html#G-TYPE-UCHAR:CAPS"><span class="type">G_TYPE_UCHAR</span></a></td>
261
<td align="left"><a href="./../glib/glib/glib-GVariantType.html#G-VARIANT-TYPE-BYTE:CAPS">'y'</a></td>
264
<td align="left"><a href="./../gobject/gobject/gobject-Type-Information.html#G-TYPE-INT:CAPS"><span class="type">G_TYPE_INT</span></a></td>
266
<a href="./../glib/glib/glib-GVariantType.html#G-VARIANT-TYPE-INT32:CAPS">'i'</a> or <a href="./../glib/glib/glib-GVariantType.html#G-VARIANT-TYPE-INT16:CAPS">'n'</a>
270
<td align="left"><a href="./../gobject/gobject/gobject-Type-Information.html#G-TYPE-UINT:CAPS"><span class="type">G_TYPE_UINT</span></a></td>
272
<a href="./../glib/glib/glib-GVariantType.html#G-VARIANT-TYPE-UINT32:CAPS">'u'</a> or <a href="./../glib/glib/glib-GVariantType.html#G-VARIANT-TYPE-UINT16:CAPS">'q'</a>
276
<td align="left"><a href="./../gobject/gobject/gobject-Type-Information.html#G-TYPE-INT64:CAPS"><span class="type">G_TYPE_INT64</span></a></td>
277
<td align="left"><a href="./../glib/glib/glib-GVariantType.html#G-VARIANT-TYPE-INT64:CAPS">'x'</a></td>
280
<td align="left"><a href="./../gobject/gobject/gobject-Type-Information.html#G-TYPE-UINT64:CAPS"><span class="type">G_TYPE_UINT64</span></a></td>
281
<td align="left"><a href="./../glib/glib/glib-GVariantType.html#G-VARIANT-TYPE-UINT64:CAPS">'t'</a></td>
284
<td align="left"><a href="./../gobject/gobject/gobject-Type-Information.html#G-TYPE-DOUBLE:CAPS"><span class="type">G_TYPE_DOUBLE</span></a></td>
285
<td align="left"><a href="./../glib/glib/glib-GVariantType.html#G-VARIANT-TYPE-DOUBLE:CAPS">'d'</a></td>
288
<td align="left"><a href="./../gobject/gobject/gobject-Type-Information.html#G-TYPE-VARIANT:CAPS"><span class="type">G_TYPE_VARIANT</span></a></td>
289
<td align="left">Any <a href="./../glib/glib/glib-GVariantType.html#GVariantType"><span class="type">GVariantType</span></a>
244
<td align="left"><a href="../gobject/gobject-Type-Information.html#G-TYPE-STRING:CAPS"><span class="type">G_TYPE_STRING</span></a></td>
246
<a href="../glib/glib-GVariantType.html#G-VARIANT-TYPE-STRING:CAPS">'s'</a>, <a href="../glib/glib-GVariantType.html#G-VARIANT-TYPE-OBJECT-PATH:CAPS">'o'</a>, <a href="../glib/glib-GVariantType.html#G-VARIANT-TYPE-SIGNATURE:CAPS">'g'</a> or <a href="../glib/glib-GVariantType.html#G-VARIANT-TYPE-BYTESTRING:CAPS">'ay'</a>
250
<td align="left"><a href="../gobject/gobject-Boxed-Types.html#G-TYPE-STRV:CAPS"><span class="type">G_TYPE_STRV</span></a></td>
252
<a href="../glib/glib-GVariantType.html#G-VARIANT-TYPE-STRING-ARRAY:CAPS">'as'</a>, <a href="../glib/glib-GVariantType.html#G-VARIANT-TYPE-OBJECT-PATH-ARRAY:CAPS">'ao'</a> or <a href="../glib/glib-GVariantType.html#G-VARIANT-TYPE-BYTESTRING-ARRAY:CAPS">'aay'</a>
256
<td align="left"><a href="../gobject/gobject-Type-Information.html#G-TYPE-BOOLEAN:CAPS"><span class="type">G_TYPE_BOOLEAN</span></a></td>
257
<td align="left"><a href="../glib/glib-GVariantType.html#G-VARIANT-TYPE-BOOLEAN:CAPS">'b'</a></td>
260
<td align="left"><a href="../gobject/gobject-Type-Information.html#G-TYPE-UCHAR:CAPS"><span class="type">G_TYPE_UCHAR</span></a></td>
261
<td align="left"><a href="../glib/glib-GVariantType.html#G-VARIANT-TYPE-BYTE:CAPS">'y'</a></td>
264
<td align="left"><a href="../gobject/gobject-Type-Information.html#G-TYPE-INT:CAPS"><span class="type">G_TYPE_INT</span></a></td>
266
<a href="../glib/glib-GVariantType.html#G-VARIANT-TYPE-INT32:CAPS">'i'</a> or <a href="../glib/glib-GVariantType.html#G-VARIANT-TYPE-INT16:CAPS">'n'</a>
270
<td align="left"><a href="../gobject/gobject-Type-Information.html#G-TYPE-UINT:CAPS"><span class="type">G_TYPE_UINT</span></a></td>
272
<a href="../glib/glib-GVariantType.html#G-VARIANT-TYPE-UINT32:CAPS">'u'</a> or <a href="../glib/glib-GVariantType.html#G-VARIANT-TYPE-UINT16:CAPS">'q'</a>
276
<td align="left"><a href="../gobject/gobject-Type-Information.html#G-TYPE-INT64:CAPS"><span class="type">G_TYPE_INT64</span></a></td>
277
<td align="left"><a href="../glib/glib-GVariantType.html#G-VARIANT-TYPE-INT64:CAPS">'x'</a></td>
280
<td align="left"><a href="../gobject/gobject-Type-Information.html#G-TYPE-UINT64:CAPS"><span class="type">G_TYPE_UINT64</span></a></td>
281
<td align="left"><a href="../glib/glib-GVariantType.html#G-VARIANT-TYPE-UINT64:CAPS">'t'</a></td>
284
<td align="left"><a href="../gobject/gobject-Type-Information.html#G-TYPE-DOUBLE:CAPS"><span class="type">G_TYPE_DOUBLE</span></a></td>
285
<td align="left"><a href="../glib/glib-GVariantType.html#G-VARIANT-TYPE-DOUBLE:CAPS">'d'</a></td>
288
<td align="left"><a href="../gobject/gobject-Type-Information.html#G-TYPE-VARIANT:CAPS"><span class="type">G_TYPE_VARIANT</span></a></td>
289
<td align="left">Any <a href="../glib/glib-GVariantType.html#GVariantType"><span class="type">GVariantType</span></a>
295
295
<p><br class="table-break">
296
This can fail if e.g. <em class="parameter"><code>gvalue</code></em> is of type <a href="./../gobject/gobject/gobject-Type-Information.html#G-TYPE-STRING:CAPS"><span class="type">G_TYPE_STRING</span></a> and <em class="parameter"><code>type</code></em>
297
is <a href="./../glib/glib/glib-GVariantType.html#G-VARIANT-TYPE-INT32:CAPS">'i'</a>. It will
298
also fail for any <a href="./../gobject/gobject/gobject-Type-Information.html#GType"><span class="type">GType</span></a> (including e.g. <a href="./../gobject/gobject/gobject-Type-Information.html#G-TYPE-OBJECT:CAPS"><span class="type">G_TYPE_OBJECT</span></a> and
299
<a href="./../gobject/gobject/gobject-Type-Information.html#G-TYPE-BOXED:CAPS"><span class="type">G_TYPE_BOXED</span></a> derived-types) not in the table above.
296
This can fail if e.g. <em class="parameter"><code>gvalue</code></em> is of type <a href="../gobject/gobject-Type-Information.html#G-TYPE-STRING:CAPS"><span class="type">G_TYPE_STRING</span></a> and <em class="parameter"><code>type</code></em>
297
is <a href="../glib/glib-GVariantType.html#G-VARIANT-TYPE-INT32:CAPS">'i'</a>. It will
298
also fail for any <a href="../gobject/gobject-Type-Information.html#GType"><span class="type">GType</span></a> (including e.g. <a href="../gobject/gobject-Type-Information.html#G-TYPE-OBJECT:CAPS"><span class="type">G_TYPE_OBJECT</span></a> and
299
<a href="../gobject/gobject-Type-Information.html#G-TYPE-BOXED:CAPS"><span class="type">G_TYPE_BOXED</span></a> derived-types) not in the table above.
302
Note that if <em class="parameter"><code>gvalue</code></em> is of type <a href="./../gobject/gobject/gobject-Type-Information.html#G-TYPE-VARIANT:CAPS"><span class="type">G_TYPE_VARIANT</span></a> and its value is
303
<a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the <span class="emphasis"><em>empty</em></span> <a href="./../glib/glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> instance (never
304
<a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>) for <em class="parameter"><code>type</code></em> is returned (e.g. 0 for scalar types, the empty
302
Note that if <em class="parameter"><code>gvalue</code></em> is of type <a href="../gobject/gobject-Type-Information.html#G-TYPE-VARIANT:CAPS"><span class="type">G_TYPE_VARIANT</span></a> and its value is
303
<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the <span class="emphasis"><em>empty</em></span> <a href="../glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> instance (never
304
<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>) for <em class="parameter"><code>type</code></em> is returned (e.g. 0 for scalar types, the empty
305
305
string for string types, <code class="literal">'/'</code> for object path
306
306
types, the empty array for any array type and so on).
309
309
See the <a class="link" href="gio-D-Bus-Utilities.html#g-dbus-gvariant-to-gvalue" title="g_dbus_gvariant_to_gvalue ()"><code class="function">g_dbus_gvariant_to_gvalue()</code></a> function for how to convert a
310
<a href="./../glib/glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> to a <a href="./../gobject/gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>.
310
<a href="../glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> to a <a href="../gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>.
312
312
<div class="variablelist"><table border="0" class="variablelist">
337
337
<div class="refsect2">
338
338
<a name="g-dbus-gvariant-to-gvalue"></a><h3>g_dbus_gvariant_to_gvalue ()</h3>
339
<pre class="programlisting"><span class="returnvalue">void</span> g_dbus_gvariant_to_gvalue (<em class="parameter"><code><a href="./../glib/glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *value</code></em>,
340
<em class="parameter"><code><a href="./../gobject/gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *out_gvalue</code></em>);</pre>
339
<pre class="programlisting"><span class="returnvalue">void</span> g_dbus_gvariant_to_gvalue (<em class="parameter"><code><a href="../glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *value</code></em>,
340
<em class="parameter"><code><a href="../gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *out_gvalue</code></em>);</pre>
342
Converts a <a href="./../glib/glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> to a <a href="./../gobject/gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>. If <em class="parameter"><code>value</code></em> is floating, it is consumed.
342
Converts a <a href="../glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> to a <a href="../gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>. If <em class="parameter"><code>value</code></em> is floating, it is consumed.
345
345
The rules specified in the <a class="link" href="gio-D-Bus-Utilities.html#g-dbus-gvalue-to-gvariant" title="g_dbus_gvalue_to_gvariant ()"><code class="function">g_dbus_gvalue_to_gvariant()</code></a> function are
346
346
used - this function is essentially its reverse form.
349
The conversion never fails - a valid <a href="./../gobject/gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> is always returned in
349
The conversion never fails - a valid <a href="../gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> is always returned in
350
350
<em class="parameter"><code>out_gvalue</code></em>.
352
352
<div class="variablelist"><table border="0" class="variablelist">