~ubuntu-branches/debian/sid/glib2.0/sid

« back to all changes in this revision

Viewing changes to docs/reference/gio/html/gio-D-Bus-Utilities.html

  • Committer: Package Import Robot
  • Author(s): Martin Pitt
  • Date: 2013-05-08 06:25:57 UTC
  • mfrom: (1.27.14) (3.1.181 experimental)
  • Revision ID: package-import@ubuntu.com-20130508062557-i7gbku66mls70gi2
Tags: 2.36.1-2
Merge experimental branch, upload to unstable.

Show diffs side-by-side

added added

removed removed

Lines of Context:
8
8
<link rel="up" href="gdbus-lowlevel.html" title="Lowlevel D-Bus Support">
9
9
<link rel="prev" href="gdbus-lowlevel.html" title="Lowlevel D-Bus Support">
10
10
<link rel="next" href="gio-D-Bus-Addresses.html" title="D-Bus Addresses">
11
 
<meta name="generator" content="GTK-Doc V1.18 (XML mode)">
 
11
<meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
</head>
14
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
40
40
<pre class="synopsis">
41
41
#include &lt;gio/gio.h&gt;
42
42
 
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>);
53
53
</pre>
54
54
</div>
55
55
<div class="refsect1">
62
62
<a name="gio-D-Bus-Utilities.details"></a><h2>Details</h2>
63
63
<div class="refsect2">
64
64
<a name="g-dbus-generate-guid"></a><h3>g_dbus_generate_guid ()</h3>
65
 
<pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             g_dbus_generate_guid                (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 
65
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             g_dbus_generate_guid                (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
66
66
<p>
67
67
Generate a D-Bus GUID that can be used with
68
68
e.g. <a class="link" href="GDBusConnection.html#g-dbus-connection-new" title="g_dbus_connection_new ()"><code class="function">g_dbus_connection_new()</code></a>.
78
78
</colgroup>
79
79
<tbody><tr>
80
80
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
81
 
<td>A valid D-Bus GUID. Free with <a href="./../glib/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.</td>
 
81
<td>A valid D-Bus GUID. Free with <a href="../glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.</td>
82
82
</tr></tbody>
83
83
</table></div>
84
84
<p class="since">Since 2.26</p>
86
86
<hr>
87
87
<div class="refsect2">
88
88
<a name="g-dbus-is-guid"></a><h3>g_dbus_is_guid ()</h3>
89
 
<pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            g_dbus_is_guid                      (<em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *string</code></em>);</pre>
 
89
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            g_dbus_is_guid                      (<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *string</code></em>);</pre>
90
90
<p>
91
91
Checks if <em class="parameter"><code>string</code></em> is a D-Bus GUID.
92
92
</p>
107
107
<tr>
108
108
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
109
109
<td>
110
 
<a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>string</code></em> is a guid, <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
 
110
<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>string</code></em> is a guid, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
111
111
</tr>
112
112
</tbody>
113
113
</table></div>
116
116
<hr>
117
117
<div class="refsect2">
118
118
<a name="g-dbus-is-name"></a><h3>g_dbus_is_name ()</h3>
119
 
<pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            g_dbus_is_name                      (<em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *string</code></em>);</pre>
 
119
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            g_dbus_is_name                      (<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *string</code></em>);</pre>
120
120
<p>
121
121
Checks if <em class="parameter"><code>string</code></em> is a valid D-Bus bus name (either unique or well-known).
122
122
</p>
133
133
<tr>
134
134
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
135
135
<td>
136
 
<a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if valid, <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
 
136
<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if valid, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
137
137
</tr>
138
138
</tbody>
139
139
</table></div>
142
142
<hr>
143
143
<div class="refsect2">
144
144
<a name="g-dbus-is-unique-name"></a><h3>g_dbus_is_unique_name ()</h3>
145
 
<pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            g_dbus_is_unique_name               (<em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *string</code></em>);</pre>
 
145
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            g_dbus_is_unique_name               (<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *string</code></em>);</pre>
146
146
<p>
147
147
Checks if <em class="parameter"><code>string</code></em> is a valid D-Bus unique bus name.
148
148
</p>
159
159
<tr>
160
160
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
161
161
<td>
162
 
<a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if valid, <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
 
162
<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if valid, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
163
163
</tr>
164
164
</tbody>
165
165
</table></div>
168
168
<hr>
169
169
<div class="refsect2">
170
170
<a name="g-dbus-is-member-name"></a><h3>g_dbus_is_member_name ()</h3>
171
 
<pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            g_dbus_is_member_name               (<em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *string</code></em>);</pre>
 
171
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            g_dbus_is_member_name               (<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *string</code></em>);</pre>
172
172
<p>
173
173
Checks if <em class="parameter"><code>string</code></em> is a valid D-Bus member (e.g. signal or method) name.
174
174
</p>
185
185
<tr>
186
186
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
187
187
<td>
188
 
<a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if valid, <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
 
188
<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if valid, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
189
189
</tr>
190
190
</tbody>
191
191
</table></div>
194
194
<hr>
195
195
<div class="refsect2">
196
196
<a name="g-dbus-is-interface-name"></a><h3>g_dbus_is_interface_name ()</h3>
197
 
<pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            g_dbus_is_interface_name            (<em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *string</code></em>);</pre>
 
197
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            g_dbus_is_interface_name            (<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *string</code></em>);</pre>
198
198
<p>
199
199
Checks if <em class="parameter"><code>string</code></em> is a valid D-Bus interface name.
200
200
</p>
211
211
<tr>
212
212
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
213
213
<td>
214
 
<a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if valid, <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
 
214
<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if valid, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
215
215
</tr>
216
216
</tbody>
217
217
</table></div>
220
220
<hr>
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>
225
225
<p>
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.
227
227
</p>
228
228
<p>
229
229
The conversion is using the following rules:
230
230
</p>
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">
234
234
<colgroup>
235
235
<col>
236
236
<col>
237
237
</colgroup>
238
238
<thead><tr>
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>
241
241
</tr></thead>
242
242
<tbody>
243
243
<tr>
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>
245
 
<td align="left">
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>
247
 
</td>
248
 
</tr>
249
 
<tr>
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>
251
 
<td align="left">
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>
253
 
</td>
254
 
</tr>
255
 
<tr>
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>
258
 
</tr>
259
 
<tr>
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>
262
 
</tr>
263
 
<tr>
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>
265
 
<td align="left">
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>
267
 
</td>
268
 
</tr>
269
 
<tr>
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>
271
 
<td align="left">
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>
273
 
</td>
274
 
</tr>
275
 
<tr>
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>
278
 
</tr>
279
 
<tr>
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>
282
 
</tr>
283
 
<tr>
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>
286
 
</tr>
287
 
<tr>
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>
 
245
<td align="left">
 
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>
 
247
</td>
 
248
</tr>
 
249
<tr>
 
250
<td align="left"><a href="../gobject/gobject-Boxed-Types.html#G-TYPE-STRV:CAPS"><span class="type">G_TYPE_STRV</span></a></td>
 
251
<td align="left">
 
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>
 
253
</td>
 
254
</tr>
 
255
<tr>
 
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>
 
258
</tr>
 
259
<tr>
 
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>
 
262
</tr>
 
263
<tr>
 
264
<td align="left"><a href="../gobject/gobject-Type-Information.html#G-TYPE-INT:CAPS"><span class="type">G_TYPE_INT</span></a></td>
 
265
<td align="left">
 
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>
 
267
</td>
 
268
</tr>
 
269
<tr>
 
270
<td align="left"><a href="../gobject/gobject-Type-Information.html#G-TYPE-UINT:CAPS"><span class="type">G_TYPE_UINT</span></a></td>
 
271
<td align="left">
 
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>
 
273
</td>
 
274
</tr>
 
275
<tr>
 
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>
 
278
</tr>
 
279
<tr>
 
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>
 
282
</tr>
 
283
<tr>
 
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>
 
286
</tr>
 
287
<tr>
 
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>
290
290
</td>
291
291
</tr>
292
292
</tbody>
293
293
</table></div>
294
294
</div>
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.
300
300
</p>
301
301
<p>
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).
307
307
</p>
308
308
<p>
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>.
311
311
</p>
312
312
<div class="variablelist"><table border="0" class="variablelist">
313
313
<colgroup>
317
317
<tbody>
318
318
<tr>
319
319
<td><p><span class="term"><em class="parameter"><code>gvalue</code></em> :</span></p></td>
320
 
<td>A <a href="./../gobject/gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to convert to a <a href="./../glib/glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a>.</td>
 
320
<td>A <a href="../gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to convert to a <a href="../glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a>.</td>
321
321
</tr>
322
322
<tr>
323
323
<td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
324
 
<td>A <a href="./../glib/glib/glib-GVariantType.html#GVariantType"><span class="type">GVariantType</span></a>.</td>
 
324
<td>A <a href="../glib/glib-GVariantType.html#GVariantType"><span class="type">GVariantType</span></a>.</td>
325
325
</tr>
326
326
<tr>
327
327
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
328
 
<td>A <a href="./../glib/glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> (never floating) of <a href="./../glib/glib/glib-GVariantType.html#GVariantType"><span class="type">GVariantType</span></a>
329
 
<em class="parameter"><code>type</code></em> holding the data from <em class="parameter"><code>gvalue</code></em> or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> in case of
330
 
failure. Free with <a href="./../glib/glib/glib-GVariant.html#g-variant-unref"><code class="function">g_variant_unref()</code></a>.</td>
 
328
<td>A <a href="../glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> (never floating) of <a href="../glib/glib-GVariantType.html#GVariantType"><span class="type">GVariantType</span></a>
 
329
<em class="parameter"><code>type</code></em> holding the data from <em class="parameter"><code>gvalue</code></em> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> in case of
 
330
failure. Free with <a href="../glib/glib-GVariant.html#g-variant-unref"><code class="function">g_variant_unref()</code></a>.</td>
331
331
</tr>
332
332
</tbody>
333
333
</table></div>
336
336
<hr>
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>
341
341
<p>
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.
343
343
</p>
344
344
<p>
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.
347
347
</p>
348
348
<p>
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>.
351
351
</p>
352
352
<div class="variablelist"><table border="0" class="variablelist">
357
357
<tbody>
358
358
<tr>
359
359
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
360
 
<td>A <a href="./../glib/glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a>.</td>
 
360
<td>A <a href="../glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a>.</td>
361
361
</tr>
362
362
<tr>
363
363
<td><p><span class="term"><em class="parameter"><code>out_gvalue</code></em> :</span></p></td>
364
 
<td>Return location pointing to a zero-filled (uninitialized) <a href="./../gobject/gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
 
364
<td>Return location pointing to a zero-filled (uninitialized) <a href="../gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
365
365
</td>
366
366
</tr>
367
367
</tbody>
372
372
</div>
373
373
<div class="footer">
374
374
<hr>
375
 
          Generated by GTK-Doc V1.18</div>
 
375
          Generated by GTK-Doc V1.18.1</div>
376
376
</body>
377
377
</html>
 
 
b'\\ No newline at end of file'