Improve g_dbus_gvalue_to_gvariant() docs
[platform/upstream/glib.git] / gio / gdbusutils.c
1 /* GDBus - GLib D-Bus Library
2  *
3  * Copyright (C) 2008-2010 Red Hat, Inc.
4  *
5  * This library is free software; you can redistribute it and/or
6  * modify it under the terms of the GNU Lesser General Public
7  * License as published by the Free Software Foundation; either
8  * version 2 of the License, or (at your option) any later version.
9  *
10  * This library is distributed in the hope that it will be useful,
11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
13  * Lesser General Public License for more details.
14  *
15  * You should have received a copy of the GNU Lesser General
16  * Public License along with this library; if not, write to the
17  * Free Software Foundation, Inc., 59 Temple Place, Suite 330,
18  * Boston, MA 02111-1307, USA.
19  *
20  * Author: David Zeuthen <davidz@redhat.com>
21  */
22
23 #include "config.h"
24
25 #include <stdlib.h>
26 #include <string.h>
27
28 #include "gdbusutils.h"
29
30 #include "glibintl.h"
31
32 /**
33  * SECTION:gdbusutils
34  * @title: D-Bus Utilities
35  * @short_description: Various utilities related to D-Bus.
36  * @include: gio/gio.h
37  *
38  * Various utility routines related to D-Bus.
39  */
40
41 static gboolean
42 is_valid_bus_name_character (gint c,
43                              gboolean allow_hyphen)
44 {
45   return
46     (c >= '0' && c <= '9') ||
47     (c >= 'A' && c <= 'Z') ||
48     (c >= 'a' && c <= 'z') ||
49     (c == '_') ||
50     (allow_hyphen && c == '-');
51 }
52
53 static gboolean
54 is_valid_initial_bus_name_character (gint c,
55                                      gboolean allow_initial_digit,
56                                      gboolean allow_hyphen)
57 {
58   if (allow_initial_digit)
59     return is_valid_bus_name_character (c, allow_hyphen);
60   else
61     return
62       (c >= 'A' && c <= 'Z') ||
63       (c >= 'a' && c <= 'z') ||
64       (c == '_') ||
65       (allow_hyphen && c == '-');
66 }
67
68 static gboolean
69 is_valid_name (const gchar *start,
70                guint len,
71                gboolean allow_initial_digit,
72                gboolean allow_hyphen)
73 {
74   gboolean ret;
75   const gchar *s;
76   const gchar *end;
77   gboolean has_dot;
78
79   ret = FALSE;
80
81   if (len == 0)
82     goto out;
83
84   s = start;
85   end = s + len;
86   has_dot = FALSE;
87   while (s != end)
88     {
89       if (*s == '.')
90         {
91           s += 1;
92           if (G_UNLIKELY (!is_valid_initial_bus_name_character (*s, allow_initial_digit, allow_hyphen)))
93             goto out;
94           has_dot = TRUE;
95         }
96       else if (G_UNLIKELY (!is_valid_bus_name_character (*s, allow_hyphen)))
97         {
98           goto out;
99         }
100       s += 1;
101     }
102
103   if (G_UNLIKELY (!has_dot))
104     goto out;
105
106   ret = TRUE;
107
108  out:
109   return ret;
110 }
111
112 /**
113  * g_dbus_is_name:
114  * @string: The string to check.
115  *
116  * Checks if @string is a valid D-Bus bus name (either unique or well-known).
117  *
118  * Returns: %TRUE if valid, %FALSE otherwise.
119  *
120  * Since: 2.26
121  */
122 gboolean
123 g_dbus_is_name (const gchar *string)
124 {
125   guint len;
126   gboolean ret;
127   const gchar *s;
128
129   g_return_val_if_fail (string != NULL, FALSE);
130
131   ret = FALSE;
132
133   len = strlen (string);
134   if (G_UNLIKELY (len == 0 || len > 255))
135     goto out;
136
137   s = string;
138   if (*s == ':')
139     {
140       /* handle unique name */
141       if (!is_valid_name (s + 1, len - 1, TRUE, TRUE))
142         goto out;
143       ret = TRUE;
144       goto out;
145     }
146   else if (G_UNLIKELY (*s == '.'))
147     {
148       /* can't start with a . */
149       goto out;
150     }
151   else if (G_UNLIKELY (!is_valid_initial_bus_name_character (*s, FALSE, TRUE)))
152     goto out;
153
154   ret = is_valid_name (s + 1, len - 1, FALSE, TRUE);
155
156  out:
157   return ret;
158 }
159
160 /**
161  * g_dbus_is_unique_name:
162  * @string: The string to check.
163  *
164  * Checks if @string is a valid D-Bus unique bus name.
165  *
166  * Returns: %TRUE if valid, %FALSE otherwise.
167  *
168  * Since: 2.26
169  */
170 gboolean
171 g_dbus_is_unique_name (const gchar *string)
172 {
173   gboolean ret;
174   guint len;
175
176   g_return_val_if_fail (string != NULL, FALSE);
177
178   ret = FALSE;
179
180   len = strlen (string);
181   if (G_UNLIKELY (len == 0 || len > 255))
182     goto out;
183
184   if (G_UNLIKELY (*string != ':'))
185     goto out;
186
187   if (G_UNLIKELY (!is_valid_name (string + 1, len - 1, TRUE, TRUE)))
188     goto out;
189
190   ret = TRUE;
191
192  out:
193   return ret;
194 }
195
196 /**
197  * g_dbus_is_member_name:
198  * @string: The string to check.
199  *
200  * Checks if @string is a valid D-Bus member (e.g. signal or method) name.
201  *
202  * Returns: %TRUE if valid, %FALSE otherwise.
203  *
204  * Since: 2.26
205  */
206 gboolean
207 g_dbus_is_member_name (const gchar *string)
208 {
209   gboolean ret;
210   guint n;
211
212   ret = FALSE;
213   if (G_UNLIKELY (string == NULL))
214     goto out;
215
216   if (G_UNLIKELY (!is_valid_initial_bus_name_character (string[0], FALSE, FALSE)))
217     goto out;
218
219   for (n = 1; string[n] != '\0'; n++)
220     {
221       if (G_UNLIKELY (!is_valid_bus_name_character (string[n], FALSE)))
222         {
223           goto out;
224         }
225     }
226
227   ret = TRUE;
228
229  out:
230   return ret;
231 }
232
233 /**
234  * g_dbus_is_interface_name:
235  * @string: The string to check.
236  *
237  * Checks if @string is a valid D-Bus interface name.
238  *
239  * Returns: %TRUE if valid, %FALSE otherwise.
240  *
241  * Since: 2.26
242  */
243 gboolean
244 g_dbus_is_interface_name (const gchar *string)
245 {
246   guint len;
247   gboolean ret;
248   const gchar *s;
249
250   g_return_val_if_fail (string != NULL, FALSE);
251
252   ret = FALSE;
253
254   len = strlen (string);
255   if (G_UNLIKELY (len == 0 || len > 255))
256     goto out;
257
258   s = string;
259   if (G_UNLIKELY (*s == '.'))
260     {
261       /* can't start with a . */
262       goto out;
263     }
264   else if (G_UNLIKELY (!is_valid_initial_bus_name_character (*s, FALSE, FALSE)))
265     goto out;
266
267   ret = is_valid_name (s + 1, len - 1, FALSE, FALSE);
268
269  out:
270   return ret;
271 }
272
273 /* ---------------------------------------------------------------------------------------------------- */
274
275 /* TODO: maybe move to glib? if so, it should conform to http://en.wikipedia.org/wiki/Guid and/or
276  *       http://tools.ietf.org/html/rfc4122 - specifically it should have hyphens then.
277  */
278
279 /**
280  * g_dbus_generate_guid:
281  *
282  * Generate a D-Bus GUID that can be used with
283  * e.g. g_dbus_connection_new().
284  *
285  * See the D-Bus specification regarding what strings are valid D-Bus
286  * GUID (for example, D-Bus GUIDs are not RFC-4122 compliant).
287  *
288  * Returns: A valid D-Bus GUID. Free with g_free().
289  *
290  * Since: 2.26
291  */
292 gchar *
293 g_dbus_generate_guid (void)
294 {
295   GString *s;
296   GTimeVal now;
297   guint32 r1;
298   guint32 r2;
299   guint32 r3;
300
301   s = g_string_new (NULL);
302
303   r1 = g_random_int ();
304   r2 = g_random_int ();
305   r3 = g_random_int ();
306   g_get_current_time (&now);
307
308   g_string_append_printf (s, "%08x", r1);
309   g_string_append_printf (s, "%08x", r2);
310   g_string_append_printf (s, "%08x", r3);
311   g_string_append_printf (s, "%08x", (guint32) now.tv_sec);
312
313   return g_string_free (s, FALSE);
314 }
315
316 /**
317  * g_dbus_is_guid:
318  * @string: The string to check.
319  *
320  * Checks if @string is a D-Bus GUID.
321  *
322  * See the D-Bus specification regarding what strings are valid D-Bus
323  * GUID (for example, D-Bus GUIDs are not RFC-4122 compliant).
324  *
325  * Returns: %TRUE if @string is a guid, %FALSE otherwise.
326  *
327  * Since: 2.26
328  */
329 gboolean
330 g_dbus_is_guid (const gchar *string)
331 {
332   gboolean ret;
333   guint n;
334
335   g_return_val_if_fail (string != NULL, FALSE);
336
337   ret = FALSE;
338
339   for (n = 0; n < 32; n++)
340     {
341       if (!g_ascii_isxdigit (string[n]))
342         goto out;
343     }
344   if (string[32] != '\0')
345     goto out;
346
347   ret = TRUE;
348
349  out:
350   return ret;
351 }
352
353 /* ---------------------------------------------------------------------------------------------------- */
354
355 /**
356  * g_dbus_gvariant_to_gvalue:
357  * @value: A #GVariant.
358  * @out_gvalue: Return location for the #GValue.
359  *
360  * Convert a #GVariant to a #GValue. If @value is floating, it is consumed.
361  *
362  * The rules specified in g_dbus_gvalue_to_gvariant() are used.
363  *
364  * Note that the passed @out_gvalue does not have to have a #GType
365  * set, as it will be initialized to the #GType corresponding to
366  * @value.
367  *
368  * This conversion can never fail.
369  *
370  * Since: 2.30
371  */
372 void
373 g_dbus_gvariant_to_gvalue (GVariant  *value,
374                            GValue    *out_gvalue)
375 {
376   const GVariantType *type;
377   gchar **array;
378
379   g_return_if_fail (value != NULL);
380   g_return_if_fail (out_gvalue != NULL);
381
382   memset (out_gvalue, '\0', sizeof (GValue));
383
384   switch (g_variant_classify (value))
385     {
386     case G_VARIANT_CLASS_BOOLEAN:
387       g_value_init (out_gvalue, G_TYPE_BOOLEAN);
388       g_value_set_boolean (out_gvalue, g_variant_get_boolean (value));
389       break;
390
391     case G_VARIANT_CLASS_BYTE:
392       g_value_init (out_gvalue, G_TYPE_UCHAR);
393       g_value_set_uchar (out_gvalue, g_variant_get_byte (value));
394       break;
395
396     case G_VARIANT_CLASS_INT16:
397       g_value_init (out_gvalue, G_TYPE_INT);
398       g_value_set_int (out_gvalue, g_variant_get_int16 (value));
399       break;
400
401     case G_VARIANT_CLASS_UINT16:
402       g_value_init (out_gvalue, G_TYPE_UINT);
403       g_value_set_uint (out_gvalue, g_variant_get_uint16 (value));
404       break;
405
406     case G_VARIANT_CLASS_INT32:
407       g_value_init (out_gvalue, G_TYPE_INT);
408       g_value_set_int (out_gvalue, g_variant_get_int32 (value));
409       break;
410
411     case G_VARIANT_CLASS_UINT32:
412       g_value_init (out_gvalue, G_TYPE_UINT);
413       g_value_set_uint (out_gvalue, g_variant_get_uint32 (value));
414       break;
415
416     case G_VARIANT_CLASS_INT64:
417       g_value_init (out_gvalue, G_TYPE_INT64);
418       g_value_set_int64 (out_gvalue, g_variant_get_int64 (value));
419       break;
420
421     case G_VARIANT_CLASS_UINT64:
422       g_value_init (out_gvalue, G_TYPE_UINT64);
423       g_value_set_uint64 (out_gvalue, g_variant_get_uint64 (value));
424       break;
425
426     case G_VARIANT_CLASS_HANDLE:
427       g_value_init (out_gvalue, G_TYPE_INT);
428       g_value_set_int (out_gvalue, g_variant_get_int32 (value));
429       break;
430
431     case G_VARIANT_CLASS_DOUBLE:
432       g_value_init (out_gvalue, G_TYPE_DOUBLE);
433       g_value_set_double (out_gvalue, g_variant_get_double (value));
434       break;
435
436     case G_VARIANT_CLASS_STRING:
437       g_value_init (out_gvalue, G_TYPE_STRING);
438       g_value_set_string (out_gvalue, g_variant_get_string (value, NULL));
439       break;
440
441     case G_VARIANT_CLASS_OBJECT_PATH:
442       g_value_init (out_gvalue, G_TYPE_STRING);
443       g_value_set_string (out_gvalue, g_variant_get_string (value, NULL));
444       break;
445
446     case G_VARIANT_CLASS_SIGNATURE:
447       g_value_init (out_gvalue, G_TYPE_STRING);
448       g_value_set_string (out_gvalue, g_variant_get_string (value, NULL));
449       break;
450
451     case G_VARIANT_CLASS_ARRAY:
452       type = g_variant_get_type (value);
453       switch (g_variant_type_peek_string (type)[1])
454         {
455         case G_VARIANT_CLASS_BYTE:
456           g_value_init (out_gvalue, G_TYPE_STRING);
457           g_value_set_string (out_gvalue, g_variant_get_bytestring (value));
458           break;
459
460         case G_VARIANT_CLASS_STRING:
461           g_value_init (out_gvalue, G_TYPE_STRV);
462           array = g_variant_dup_strv (value, NULL);
463           g_value_take_boxed (out_gvalue, array);
464           break;
465
466         case G_VARIANT_CLASS_ARRAY:
467           switch (g_variant_type_peek_string (type)[2])
468             {
469             case G_VARIANT_CLASS_BYTE:
470               g_value_init (out_gvalue, G_TYPE_STRV);
471               array = g_variant_dup_bytestring_array (value, NULL);
472               g_value_take_boxed (out_gvalue, array);
473               break;
474
475             default:
476               g_value_init (out_gvalue, G_TYPE_VARIANT);
477               g_value_set_variant (out_gvalue, value);
478               break;
479             }
480           break;
481
482         default:
483           g_value_init (out_gvalue, G_TYPE_VARIANT);
484           g_value_set_variant (out_gvalue, value);
485           break;
486         }
487       break;
488
489     case G_VARIANT_CLASS_VARIANT:
490     case G_VARIANT_CLASS_MAYBE:
491     case G_VARIANT_CLASS_TUPLE:
492     case G_VARIANT_CLASS_DICT_ENTRY:
493       g_value_init (out_gvalue, G_TYPE_VARIANT);
494       g_value_set_variant (out_gvalue, value);
495       break;
496     }
497 }
498
499
500 /**
501  * g_dbus_gvalue_to_gvariant:
502  * @gvalue: A #GValue to convert to a #GVariant.
503  * @expected_type: The #GVariantType to create.
504  *
505  * Convert a #GValue to #GVariant.
506  *
507  * The conversion is using the following rules:
508  * <table frame='all'>
509  *   <title>#GValue / #GVariant conversion rules</title>
510  *   <tgroup cols='2' align='left' colsep='1' rowsep='1'>
511  *     <thead>
512  *       <row>
513  *         <entry>If the #GType for @gvalue is...</entry>
514  *         <entry>... then @expected_type must be</entry>
515  *       </row>
516  *     </thead>
517  *     <tbody>
518  *       <row>
519  *         <entry>#G_TYPE_STRING</entry>
520  *         <entry><link linkend="G-VARIANT-TYPE-STRING:CAPS">s</link>, <link linkend="G-VARIANT-TYPE-OBJECT-PATH:CAPS">o</link>, <link linkend="G-VARIANT-TYPE-SIGNATURE:CAPS">g</link>, <link linkend="G-VARIANT-TYPE-BYTESTRING:CAPS">ay</link></entry>
521  *       </row>
522  *       <row>
523  *         <entry>#G_TYPE_STRV</entry>
524  *         <entry><link linkend="G-VARIANT-TYPE-STRING-ARRAY:CAPS">as</link>, <link linkend="G-VARIANT-TYPE-BYTESTRING-ARRAY:CAPS">aay</link></entry>
525  *       </row>
526  *       <row>
527  *         <entry>#G_TYPE_BOOLEAN</entry>
528  *         <entry><link linkend="G-VARIANT-TYPE-BOOLEAN:CAPS">b</link></entry>
529  *       </row>
530  *       <row>
531  *         <entry>#G_TYPE_UCHAR</entry>
532  *         <entry><link linkend="G-VARIANT-TYPE-BYTE:CAPS">y</link></entry>
533  *       </row>
534  *       <row>
535  *         <entry>#G_TYPE_INT</entry>
536  *         <entry><link linkend="G-VARIANT-TYPE-INT32:CAPS">i</link>, <link linkend="G-VARIANT-TYPE-INT16:CAPS">n</link></entry>
537  *       </row>
538  *       <row>
539  *         <entry>#G_TYPE_UINT</entry>
540  *         <entry><link linkend="G-VARIANT-TYPE-UINT32:CAPS">u</link>, <link linkend="G-VARIANT-TYPE-UINT16:CAPS">q</link></entry>
541  *       </row>
542  *       <row>
543  *         <entry>#G_TYPE_INT64</entry>
544  *         <entry><link linkend="G-VARIANT-TYPE-INT64:CAPS">x</link></entry>
545  *       </row>
546  *       <row>
547  *         <entry>#G_TYPE_UINT64</entry>
548  *         <entry><link linkend="G-VARIANT-TYPE-UINT64:CAPS">t</link></entry>
549  *       </row>
550  *       <row>
551  *         <entry>#G_TYPE_INT</entry>
552  *         <entry><link linkend="G-VARIANT-TYPE-HANDLE:CAPS">h</link></entry>
553  *       </row>
554  *       <row>
555  *         <entry>#G_TYPE_DOUBLE</entry>
556  *         <entry><link linkend="G-VARIANT-TYPE-DOUBLE:CAPS">d</link></entry>
557  *       </row>
558  *       <row>
559  *         <entry>#G_TYPE_VARIANT</entry>
560  *         <entry>Any #GVariantType</entry>
561  *       </row>
562  *     </tbody>
563  *   </tgroup>
564  * </table>
565  * This can fail if e.g. @gvalue is of type #G_TYPE_STRING and
566  * @expected_type is <literal>'i'</literal>. It will also fail for any
567  * #GType (including e.g. #G_TYPE_OBJECT and #G_TYPE_BOXED
568  * derived-types) not in the table above.
569  *
570  * Note that if @gvalue is of type #G_TYPE_VARIANT and its value is
571  * %NULL, the <emphasis>empty</emphasis> #GVariant instance (never
572  * %NULL) for @expected_type is returned (e.g. 0 for scalar types, the
573  * empty string for string types and so on).
574  *
575  * Returns: A #GVariant (never floating) of #GVariantType
576  * @expected_type holding the data from @gvalue or %NULL in case of
577  * failure. Free with g_variant_unref().
578  *
579  * Since: 2.30
580  */
581 GVariant *
582 g_dbus_gvalue_to_gvariant (const GValue         *gvalue,
583                            const GVariantType   *expected_type)
584 {
585   GVariant *ret;
586   const gchar *s;
587   const gchar * const *as;
588   const gchar *empty_strv[1] = {NULL};
589
590   g_return_val_if_fail (gvalue != NULL, NULL);
591   g_return_val_if_fail (expected_type != NULL, NULL);
592
593   ret = NULL;
594
595   /* The expected type could easily be e.g. "s" with the GValue holding a string.
596    * because of the UseGVariant annotation
597    */
598   if (G_VALUE_TYPE (gvalue) == G_TYPE_VARIANT)
599     {
600       ret = g_value_dup_variant (gvalue);
601     }
602   else
603     {
604       switch (g_variant_type_peek_string (expected_type)[0])
605         {
606         case G_VARIANT_CLASS_BOOLEAN:
607           ret = g_variant_ref_sink (g_variant_new_boolean (g_value_get_boolean (gvalue)));
608           break;
609
610         case G_VARIANT_CLASS_BYTE:
611           ret = g_variant_ref_sink (g_variant_new_byte (g_value_get_uchar (gvalue)));
612           break;
613
614         case G_VARIANT_CLASS_INT16:
615           ret = g_variant_ref_sink (g_variant_new_int16 (g_value_get_int (gvalue)));
616           break;
617
618         case G_VARIANT_CLASS_UINT16:
619           ret = g_variant_ref_sink (g_variant_new_uint16 (g_value_get_uint (gvalue)));
620           break;
621
622         case G_VARIANT_CLASS_INT32:
623           ret = g_variant_ref_sink (g_variant_new_int32 (g_value_get_int (gvalue)));
624           break;
625
626         case G_VARIANT_CLASS_UINT32:
627           ret = g_variant_ref_sink (g_variant_new_uint32 (g_value_get_uint (gvalue)));
628           break;
629
630         case G_VARIANT_CLASS_INT64:
631           ret = g_variant_ref_sink (g_variant_new_int64 (g_value_get_int64 (gvalue)));
632           break;
633
634         case G_VARIANT_CLASS_UINT64:
635           ret = g_variant_ref_sink (g_variant_new_uint64 (g_value_get_uint64 (gvalue)));
636           break;
637
638         case G_VARIANT_CLASS_HANDLE:
639           ret = g_variant_ref_sink (g_variant_new_handle (g_value_get_int (gvalue)));
640           break;
641
642         case G_VARIANT_CLASS_DOUBLE:
643           ret = g_variant_ref_sink (g_variant_new_double (g_value_get_double (gvalue)));
644           break;
645
646         case G_VARIANT_CLASS_STRING:
647           s = g_value_get_string (gvalue);
648           if (s == NULL)
649             s = "";
650           ret = g_variant_ref_sink (g_variant_new_string (s));
651           break;
652
653         case G_VARIANT_CLASS_OBJECT_PATH:
654           s = g_value_get_string (gvalue);
655           if (s == NULL)
656             s = "/";
657           ret = g_variant_ref_sink (g_variant_new_object_path (s));
658           break;
659
660         case G_VARIANT_CLASS_SIGNATURE:
661           s = g_value_get_string (gvalue);
662           if (s == NULL)
663             s = "";
664           ret = g_variant_ref_sink (g_variant_new_signature (s));
665           break;
666
667         case G_VARIANT_CLASS_ARRAY:
668           switch (g_variant_type_peek_string (expected_type)[1])
669             {
670             case G_VARIANT_CLASS_BYTE:
671               s = g_value_get_string (gvalue);
672               if (s == NULL)
673                 s = "";
674               ret = g_variant_ref_sink (g_variant_new_bytestring (s));
675               break;
676
677             case G_VARIANT_CLASS_STRING:
678               as = g_value_get_boxed (gvalue);
679               if (as == NULL)
680                 as = empty_strv;
681               ret = g_variant_ref_sink (g_variant_new_strv (as, -1));
682               break;
683
684             case G_VARIANT_CLASS_ARRAY:
685               switch (g_variant_type_peek_string (expected_type)[2])
686                 {
687                 case G_VARIANT_CLASS_BYTE:
688                   as = g_value_get_boxed (gvalue);
689                   if (as == NULL)
690                     as = empty_strv;
691                   ret = g_variant_ref_sink (g_variant_new_bytestring_array (as, -1));
692                   break;
693
694                 default:
695                   ret = g_value_dup_variant (gvalue);
696                   break;
697                 }
698               break;
699
700             default:
701               ret = g_value_dup_variant (gvalue);
702               break;
703             }
704           break;
705
706         default:
707         case G_VARIANT_CLASS_VARIANT:
708         case G_VARIANT_CLASS_MAYBE:
709         case G_VARIANT_CLASS_TUPLE:
710         case G_VARIANT_CLASS_DICT_ENTRY:
711           ret = g_value_dup_variant (gvalue);
712           break;
713         }
714     }
715
716   /* Could be that the GValue is holding a NULL GVariant - in that case,
717    * we return an "empty" GVariant instead of a NULL GVariant
718    */
719   if (ret == NULL)
720     {
721       GVariant *untrusted_empty;
722       untrusted_empty = g_variant_new_from_data (expected_type, NULL, 0, FALSE, NULL, NULL);
723       ret = g_variant_ref_sink (g_variant_get_normal_form (untrusted_empty));
724       g_variant_unref (untrusted_empty);
725     }
726
727   g_assert (!g_variant_is_floating (ret));
728
729   return ret;
730 }