1/*
2 * Copyright © 2007, 2008 Ryan Lortie
3 * Copyright © 2009, 2010 Codethink Limited
4 *
5 * SPDX-License-Identifier: LGPL-2.1-or-later
6 *
7 * This library is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2.1 of the License, or (at your option) any later version.
11 *
12 * This library is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
16 *
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with this library; if not, see <http://www.gnu.org/licenses/>.
19 *
20 * Author: Ryan Lortie <desrt@desrt.ca>
21 */
22
23#ifndef __G_VARIANT_H__
24#define __G_VARIANT_H__
25
26#if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION)
27#error "Only <glib.h> can be included directly."
28#endif
29
30#include <glib/gvarianttype.h>
31#include <glib/gstring.h>
32#include <glib/gbytes.h>
33
34G_BEGIN_DECLS
35
36typedef struct _GVariant GVariant;
37
38typedef enum
39{
40 G_VARIANT_CLASS_BOOLEAN = 'b',
41 G_VARIANT_CLASS_BYTE = 'y',
42 G_VARIANT_CLASS_INT16 = 'n',
43 G_VARIANT_CLASS_UINT16 = 'q',
44 G_VARIANT_CLASS_INT32 = 'i',
45 G_VARIANT_CLASS_UINT32 = 'u',
46 G_VARIANT_CLASS_INT64 = 'x',
47 G_VARIANT_CLASS_UINT64 = 't',
48 G_VARIANT_CLASS_HANDLE = 'h',
49 G_VARIANT_CLASS_DOUBLE = 'd',
50 G_VARIANT_CLASS_STRING = 's',
51 G_VARIANT_CLASS_OBJECT_PATH = 'o',
52 G_VARIANT_CLASS_SIGNATURE = 'g',
53 G_VARIANT_CLASS_VARIANT = 'v',
54 G_VARIANT_CLASS_MAYBE = 'm',
55 G_VARIANT_CLASS_ARRAY = 'a',
56 G_VARIANT_CLASS_TUPLE = '(',
57 G_VARIANT_CLASS_DICT_ENTRY = '{'
58} GVariantClass;
59
60GLIB_AVAILABLE_IN_ALL
61void g_variant_unref (GVariant *value);
62GLIB_AVAILABLE_IN_ALL
63GVariant * g_variant_ref (GVariant *value);
64GLIB_AVAILABLE_IN_ALL
65GVariant * g_variant_ref_sink (GVariant *value);
66GLIB_AVAILABLE_IN_ALL
67gboolean g_variant_is_floating (GVariant *value);
68GLIB_AVAILABLE_IN_ALL
69GVariant * g_variant_take_ref (GVariant *value);
70
71GLIB_AVAILABLE_IN_ALL
72const GVariantType * g_variant_get_type (GVariant *value);
73GLIB_AVAILABLE_IN_ALL
74const gchar * g_variant_get_type_string (GVariant *value);
75GLIB_AVAILABLE_IN_ALL
76gboolean g_variant_is_of_type (GVariant *value,
77 const GVariantType *type);
78GLIB_AVAILABLE_IN_ALL
79gboolean g_variant_is_container (GVariant *value);
80GLIB_AVAILABLE_IN_ALL
81GVariantClass g_variant_classify (GVariant *value);
82GLIB_AVAILABLE_IN_ALL
83GVariant * g_variant_new_boolean (gboolean value);
84GLIB_AVAILABLE_IN_ALL
85GVariant * g_variant_new_byte (guint8 value);
86GLIB_AVAILABLE_IN_ALL
87GVariant * g_variant_new_int16 (gint16 value);
88GLIB_AVAILABLE_IN_ALL
89GVariant * g_variant_new_uint16 (guint16 value);
90GLIB_AVAILABLE_IN_ALL
91GVariant * g_variant_new_int32 (gint32 value);
92GLIB_AVAILABLE_IN_ALL
93GVariant * g_variant_new_uint32 (guint32 value);
94GLIB_AVAILABLE_IN_ALL
95GVariant * g_variant_new_int64 (gint64 value);
96GLIB_AVAILABLE_IN_ALL
97GVariant * g_variant_new_uint64 (guint64 value);
98GLIB_AVAILABLE_IN_ALL
99GVariant * g_variant_new_handle (gint32 value);
100GLIB_AVAILABLE_IN_ALL
101GVariant * g_variant_new_double (gdouble value);
102GLIB_AVAILABLE_IN_ALL
103GVariant * g_variant_new_string (const gchar *string);
104GLIB_AVAILABLE_IN_2_38
105GVariant * g_variant_new_take_string (gchar *string);
106GLIB_AVAILABLE_IN_2_38
107GVariant * g_variant_new_printf (const gchar *format_string,
108 ...) G_GNUC_PRINTF (1, 2);
109GLIB_AVAILABLE_IN_ALL
110GVariant * g_variant_new_object_path (const gchar *object_path);
111GLIB_AVAILABLE_IN_ALL
112gboolean g_variant_is_object_path (const gchar *string);
113GLIB_AVAILABLE_IN_ALL
114GVariant * g_variant_new_signature (const gchar *signature);
115GLIB_AVAILABLE_IN_ALL
116gboolean g_variant_is_signature (const gchar *string);
117GLIB_AVAILABLE_IN_ALL
118GVariant * g_variant_new_variant (GVariant *value);
119GLIB_AVAILABLE_IN_ALL
120GVariant * g_variant_new_strv (const gchar * const *strv,
121 gssize length);
122GLIB_AVAILABLE_IN_2_30
123GVariant * g_variant_new_objv (const gchar * const *strv,
124 gssize length);
125GLIB_AVAILABLE_IN_ALL
126GVariant * g_variant_new_bytestring (const gchar *string);
127GLIB_AVAILABLE_IN_ALL
128GVariant * g_variant_new_bytestring_array (const gchar * const *strv,
129 gssize length);
130GLIB_AVAILABLE_IN_ALL
131GVariant * g_variant_new_fixed_array (const GVariantType *element_type,
132 gconstpointer elements,
133 gsize n_elements,
134 gsize element_size);
135GLIB_AVAILABLE_IN_ALL
136gboolean g_variant_get_boolean (GVariant *value);
137GLIB_AVAILABLE_IN_ALL
138guint8 g_variant_get_byte (GVariant *value);
139GLIB_AVAILABLE_IN_ALL
140gint16 g_variant_get_int16 (GVariant *value);
141GLIB_AVAILABLE_IN_ALL
142guint16 g_variant_get_uint16 (GVariant *value);
143GLIB_AVAILABLE_IN_ALL
144gint32 g_variant_get_int32 (GVariant *value);
145GLIB_AVAILABLE_IN_ALL
146guint32 g_variant_get_uint32 (GVariant *value);
147GLIB_AVAILABLE_IN_ALL
148gint64 g_variant_get_int64 (GVariant *value);
149GLIB_AVAILABLE_IN_ALL
150guint64 g_variant_get_uint64 (GVariant *value);
151GLIB_AVAILABLE_IN_ALL
152gint32 g_variant_get_handle (GVariant *value);
153GLIB_AVAILABLE_IN_ALL
154gdouble g_variant_get_double (GVariant *value);
155GLIB_AVAILABLE_IN_ALL
156GVariant * g_variant_get_variant (GVariant *value);
157GLIB_AVAILABLE_IN_ALL
158const gchar * g_variant_get_string (GVariant *value,
159 gsize *length);
160GLIB_AVAILABLE_IN_ALL
161gchar * g_variant_dup_string (GVariant *value,
162 gsize *length);
163GLIB_AVAILABLE_IN_ALL
164const gchar ** g_variant_get_strv (GVariant *value,
165 gsize *length);
166GLIB_AVAILABLE_IN_ALL
167gchar ** g_variant_dup_strv (GVariant *value,
168 gsize *length);
169GLIB_AVAILABLE_IN_2_30
170const gchar ** g_variant_get_objv (GVariant *value,
171 gsize *length);
172GLIB_AVAILABLE_IN_ALL
173gchar ** g_variant_dup_objv (GVariant *value,
174 gsize *length);
175GLIB_AVAILABLE_IN_ALL
176const gchar * g_variant_get_bytestring (GVariant *value);
177GLIB_AVAILABLE_IN_ALL
178gchar * g_variant_dup_bytestring (GVariant *value,
179 gsize *length);
180GLIB_AVAILABLE_IN_ALL
181const gchar ** g_variant_get_bytestring_array (GVariant *value,
182 gsize *length);
183GLIB_AVAILABLE_IN_ALL
184gchar ** g_variant_dup_bytestring_array (GVariant *value,
185 gsize *length);
186
187GLIB_AVAILABLE_IN_ALL
188GVariant * g_variant_new_maybe (const GVariantType *child_type,
189 GVariant *child);
190GLIB_AVAILABLE_IN_ALL
191GVariant * g_variant_new_array (const GVariantType *child_type,
192 GVariant * const *children,
193 gsize n_children);
194GLIB_AVAILABLE_IN_ALL
195GVariant * g_variant_new_tuple (GVariant * const *children,
196 gsize n_children);
197GLIB_AVAILABLE_IN_ALL
198GVariant * g_variant_new_dict_entry (GVariant *key,
199 GVariant *value);
200
201GLIB_AVAILABLE_IN_ALL
202GVariant * g_variant_get_maybe (GVariant *value);
203GLIB_AVAILABLE_IN_ALL
204gsize g_variant_n_children (GVariant *value);
205GLIB_AVAILABLE_IN_ALL
206void g_variant_get_child (GVariant *value,
207 gsize index_,
208 const gchar *format_string,
209 ...);
210GLIB_AVAILABLE_IN_ALL
211GVariant * g_variant_get_child_value (GVariant *value,
212 gsize index_);
213GLIB_AVAILABLE_IN_ALL
214gboolean g_variant_lookup (GVariant *dictionary,
215 const gchar *key,
216 const gchar *format_string,
217 ...);
218GLIB_AVAILABLE_IN_ALL
219GVariant * g_variant_lookup_value (GVariant *dictionary,
220 const gchar *key,
221 const GVariantType *expected_type);
222GLIB_AVAILABLE_IN_ALL
223gconstpointer g_variant_get_fixed_array (GVariant *value,
224 gsize *n_elements,
225 gsize element_size);
226
227GLIB_AVAILABLE_IN_ALL
228gsize g_variant_get_size (GVariant *value);
229GLIB_AVAILABLE_IN_ALL
230gconstpointer g_variant_get_data (GVariant *value);
231GLIB_AVAILABLE_IN_2_36
232GBytes * g_variant_get_data_as_bytes (GVariant *value);
233GLIB_AVAILABLE_IN_ALL
234void g_variant_store (GVariant *value,
235 gpointer data);
236
237GLIB_AVAILABLE_IN_ALL
238gchar * g_variant_print (GVariant *value,
239 gboolean type_annotate);
240GLIB_AVAILABLE_IN_ALL
241GString * g_variant_print_string (GVariant *value,
242 GString *string,
243 gboolean type_annotate);
244
245GLIB_AVAILABLE_IN_ALL
246guint g_variant_hash (gconstpointer value);
247GLIB_AVAILABLE_IN_ALL
248gboolean g_variant_equal (gconstpointer one,
249 gconstpointer two);
250
251GLIB_AVAILABLE_IN_ALL
252GVariant * g_variant_get_normal_form (GVariant *value);
253GLIB_AVAILABLE_IN_ALL
254gboolean g_variant_is_normal_form (GVariant *value);
255GLIB_AVAILABLE_IN_ALL
256GVariant * g_variant_byteswap (GVariant *value);
257
258GLIB_AVAILABLE_IN_2_36
259GVariant * g_variant_new_from_bytes (const GVariantType *type,
260 GBytes *bytes,
261 gboolean trusted);
262GLIB_AVAILABLE_IN_ALL
263GVariant * g_variant_new_from_data (const GVariantType *type,
264 gconstpointer data,
265 gsize size,
266 gboolean trusted,
267 GDestroyNotify notify,
268 gpointer user_data);
269
270typedef struct _GVariantIter GVariantIter;
271struct _GVariantIter {
272 /*< private >*/
273 guintptr x[16];
274};
275
276GLIB_AVAILABLE_IN_ALL
277GVariantIter * g_variant_iter_new (GVariant *value);
278GLIB_AVAILABLE_IN_ALL
279gsize g_variant_iter_init (GVariantIter *iter,
280 GVariant *value);
281GLIB_AVAILABLE_IN_ALL
282GVariantIter * g_variant_iter_copy (GVariantIter *iter);
283GLIB_AVAILABLE_IN_ALL
284gsize g_variant_iter_n_children (GVariantIter *iter);
285GLIB_AVAILABLE_IN_ALL
286void g_variant_iter_free (GVariantIter *iter);
287GLIB_AVAILABLE_IN_ALL
288GVariant * g_variant_iter_next_value (GVariantIter *iter);
289GLIB_AVAILABLE_IN_ALL
290gboolean g_variant_iter_next (GVariantIter *iter,
291 const gchar *format_string,
292 ...);
293GLIB_AVAILABLE_IN_ALL
294gboolean g_variant_iter_loop (GVariantIter *iter,
295 const gchar *format_string,
296 ...);
297
298
299typedef struct _GVariantBuilder GVariantBuilder;
300struct _GVariantBuilder {
301 /*< private >*/
302 union
303 {
304 struct {
305 gsize partial_magic;
306 const GVariantType *type;
307 guintptr y[14];
308 } s;
309 guintptr x[16];
310 } u;
311};
312
313typedef enum
314{
315 G_VARIANT_PARSE_ERROR_FAILED,
316 G_VARIANT_PARSE_ERROR_BASIC_TYPE_EXPECTED,
317 G_VARIANT_PARSE_ERROR_CANNOT_INFER_TYPE,
318 G_VARIANT_PARSE_ERROR_DEFINITE_TYPE_EXPECTED,
319 G_VARIANT_PARSE_ERROR_INPUT_NOT_AT_END,
320 G_VARIANT_PARSE_ERROR_INVALID_CHARACTER,
321 G_VARIANT_PARSE_ERROR_INVALID_FORMAT_STRING,
322 G_VARIANT_PARSE_ERROR_INVALID_OBJECT_PATH,
323 G_VARIANT_PARSE_ERROR_INVALID_SIGNATURE,
324 G_VARIANT_PARSE_ERROR_INVALID_TYPE_STRING,
325 G_VARIANT_PARSE_ERROR_NO_COMMON_TYPE,
326 G_VARIANT_PARSE_ERROR_NUMBER_OUT_OF_RANGE,
327 G_VARIANT_PARSE_ERROR_NUMBER_TOO_BIG,
328 G_VARIANT_PARSE_ERROR_TYPE_ERROR,
329 G_VARIANT_PARSE_ERROR_UNEXPECTED_TOKEN,
330 G_VARIANT_PARSE_ERROR_UNKNOWN_KEYWORD,
331 G_VARIANT_PARSE_ERROR_UNTERMINATED_STRING_CONSTANT,
332 G_VARIANT_PARSE_ERROR_VALUE_EXPECTED,
333 G_VARIANT_PARSE_ERROR_RECURSION
334} GVariantParseError;
335#define G_VARIANT_PARSE_ERROR (g_variant_parse_error_quark ())
336
337GLIB_DEPRECATED_IN_2_38_FOR(g_variant_parse_error_quark)
338GQuark g_variant_parser_get_error_quark (void);
339
340GLIB_AVAILABLE_IN_ALL
341GQuark g_variant_parse_error_quark (void);
342
343/**
344 * G_VARIANT_BUILDER_INIT:
345 * @variant_type: a const GVariantType*
346 *
347 * A stack-allocated [struct@GLib.VariantBuilder] must be initialized
348 * if it is used together with
349 * [`g_auto()`](auto-cleanup.html#variable-declaration). This macro can
350 * be used as initializer when declaring the builder, but it cannot be
351 * assigned to a variable.
352 *
353 * The effects of initializing the builder with
354 * `G_VARIANT_BUILDER_INIT` is the same as initializing it with
355 * [func@GLib.VARIANT_BUILDER_INIT_UNSET], followed by a call to
356 * [method@GLib.VariantBuilder.init].
357 *
358 * The passed @variant_type should be a static [type@GLib.VariantType]
359 * to avoid lifetime issues, as copying the @variant_type does not
360 * happen in the `G_VARIANT_BUILDER_INIT` call, but rather in functions
361 * that make sure that [struct@GLib.VariantBuilder] is valid.
362 *
363 * ```c
364 * g_auto(GVariantBuilder) builder = G_VARIANT_BUILDER_INIT (G_VARIANT_TYPE_BYTESTRING);
365 * ```
366 *
367 * Since: 2.50
368 */
369#define G_VARIANT_BUILDER_INIT(variant_type) \
370 { \
371 { \
372 { \
373 2942751021u /* == GVSB_MAGIC_PARTIAL, see gvariant.c */, variant_type, { 0, } \
374 } \
375 } \
376 }
377
378/**
379 * G_VARIANT_BUILDER_INIT_UNSET:
380 *
381 * A stack-allocated [struct@GLib.VariantBuilder] must be initialized
382 * if it is used together with
383 * [`g_auto()`](auto-cleanup.html#variable-declaration). This macro can
384 * be used as initializer when declaring the builder, but it cannot be
385 * assigned to a variable.
386 *
387 * The builder can be initialized to a specific [type@GLib.VariantType]
388 * later with [method@GLib.VariantBuilder.init].
389 *
390 * Use [func@GLib.VARIANT_BUILDER_INIT] to directly initialize the
391 * builder with a specific [type@GLib.VariantType].
392 *
393 * ```c
394 * g_auto(GVariantBuilder) builder = G_VARIANT_BUILDER_INIT_UNSET ();
395 *
396 * if (condition)
397 * return NULL;
398 *
399 * g_variant_builder_init (&builder, G_VARIANT_TYPE ("a{su}"));
400 * return g_variant_ref_sink (g_variant_builder_end (&builder));
401 * ```
402 *
403 * Since: 2.84
404 */
405#define G_VARIANT_BUILDER_INIT_UNSET() \
406 { \
407 0, \
408 } GLIB_AVAILABLE_MACRO_IN_2_84
409
410GLIB_AVAILABLE_IN_ALL
411GVariantBuilder * g_variant_builder_new (const GVariantType *type);
412GLIB_AVAILABLE_IN_ALL
413void g_variant_builder_unref (GVariantBuilder *builder);
414GLIB_AVAILABLE_IN_ALL
415GVariantBuilder * g_variant_builder_ref (GVariantBuilder *builder);
416GLIB_AVAILABLE_IN_ALL
417void g_variant_builder_init (GVariantBuilder *builder,
418 const GVariantType *type);
419GLIB_AVAILABLE_IN_2_84
420void g_variant_builder_init_static (GVariantBuilder *builder,
421 const GVariantType *type);
422GLIB_AVAILABLE_IN_ALL
423GVariant * g_variant_builder_end (GVariantBuilder *builder);
424GLIB_AVAILABLE_IN_ALL
425void g_variant_builder_clear (GVariantBuilder *builder);
426GLIB_AVAILABLE_IN_ALL
427void g_variant_builder_open (GVariantBuilder *builder,
428 const GVariantType *type);
429GLIB_AVAILABLE_IN_ALL
430void g_variant_builder_close (GVariantBuilder *builder);
431GLIB_AVAILABLE_IN_ALL
432void g_variant_builder_add_value (GVariantBuilder *builder,
433 GVariant *value);
434GLIB_AVAILABLE_IN_ALL
435void g_variant_builder_add (GVariantBuilder *builder,
436 const gchar *format_string,
437 ...);
438GLIB_AVAILABLE_IN_ALL
439void g_variant_builder_add_parsed (GVariantBuilder *builder,
440 const gchar *format,
441 ...);
442
443GLIB_AVAILABLE_IN_ALL
444GVariant * g_variant_new (const gchar *format_string,
445 ...);
446GLIB_AVAILABLE_IN_ALL
447void g_variant_get (GVariant *value,
448 const gchar *format_string,
449 ...);
450GLIB_AVAILABLE_IN_ALL
451GVariant * g_variant_new_va (const gchar *format_string,
452 const gchar **endptr,
453 va_list *app);
454GLIB_AVAILABLE_IN_ALL
455void g_variant_get_va (GVariant *value,
456 const gchar *format_string,
457 const gchar **endptr,
458 va_list *app);
459GLIB_AVAILABLE_IN_2_34
460gboolean g_variant_check_format_string (GVariant *value,
461 const gchar *format_string,
462 gboolean copy_only);
463
464GLIB_AVAILABLE_IN_ALL
465GVariant * g_variant_parse (const GVariantType *type,
466 const gchar *text,
467 const gchar *limit,
468 const gchar **endptr,
469 GError **error);
470GLIB_AVAILABLE_IN_ALL
471GVariant * g_variant_new_parsed (const gchar *format,
472 ...);
473GLIB_AVAILABLE_IN_ALL
474GVariant * g_variant_new_parsed_va (const gchar *format,
475 va_list *app);
476
477GLIB_AVAILABLE_IN_2_40
478gchar * g_variant_parse_error_print_context (GError *error,
479 const gchar *source_str);
480
481GLIB_AVAILABLE_IN_ALL
482gint g_variant_compare (gconstpointer one,
483 gconstpointer two);
484
485typedef struct _GVariantDict GVariantDict;
486struct _GVariantDict {
487 /*< private >*/
488 union
489 {
490 struct {
491 GVariant *asv;
492 gsize partial_magic;
493 guintptr y[14];
494 } s;
495 guintptr x[16];
496 } u;
497};
498
499/**
500 * G_VARIANT_DICT_INIT:
501 * @asv: (nullable): a GVariant*
502 *
503 * A stack-allocated #GVariantDict must be initialized if it is used
504 * together with g_auto() to avoid warnings or crashes if function
505 * returns before g_variant_dict_init() is called on the builder.
506 *
507 * This macro can be used as initializer instead of an explicit
508 * zeroing a variable when declaring it and a following
509 * g_variant_dict_init(), but it cannot be assigned to a variable.
510 *
511 * The passed @asv has to live long enough for #GVariantDict to gather
512 * the entries from, as the gathering does not happen in the
513 * G_VARIANT_DICT_INIT() call, but rather in functions that make sure
514 * that #GVariantDict is valid. In context where the initialization
515 * value has to be a constant expression, the only possible value of
516 * @asv is %NULL. It is still possible to call g_variant_dict_init()
517 * safely with a different @asv right after the variable was
518 * initialized with G_VARIANT_DICT_INIT().
519 *
520 * |[<!-- language="C" -->
521 * g_autoptr(GVariant) variant = get_asv_variant ();
522 * g_auto(GVariantDict) dict = G_VARIANT_DICT_INIT (variant);
523 * ]|
524 *
525 * Since: 2.50
526 */
527#define G_VARIANT_DICT_INIT(asv) \
528 { \
529 { \
530 { \
531 asv, 3488698669u /* == GVSD_MAGIC_PARTIAL, see gvariant.c */, { 0, } \
532 } \
533 } \
534 }
535
536GLIB_AVAILABLE_IN_2_40
537GVariantDict * g_variant_dict_new (GVariant *from_asv);
538
539GLIB_AVAILABLE_IN_2_40
540void g_variant_dict_init (GVariantDict *dict,
541 GVariant *from_asv);
542
543GLIB_AVAILABLE_IN_2_40
544gboolean g_variant_dict_lookup (GVariantDict *dict,
545 const gchar *key,
546 const gchar *format_string,
547 ...);
548GLIB_AVAILABLE_IN_2_40
549GVariant * g_variant_dict_lookup_value (GVariantDict *dict,
550 const gchar *key,
551 const GVariantType *expected_type);
552GLIB_AVAILABLE_IN_2_40
553gboolean g_variant_dict_contains (GVariantDict *dict,
554 const gchar *key);
555GLIB_AVAILABLE_IN_2_40
556void g_variant_dict_insert (GVariantDict *dict,
557 const gchar *key,
558 const gchar *format_string,
559 ...);
560GLIB_AVAILABLE_IN_2_40
561void g_variant_dict_insert_value (GVariantDict *dict,
562 const gchar *key,
563 GVariant *value);
564GLIB_AVAILABLE_IN_2_40
565gboolean g_variant_dict_remove (GVariantDict *dict,
566 const gchar *key);
567GLIB_AVAILABLE_IN_2_40
568void g_variant_dict_clear (GVariantDict *dict);
569GLIB_AVAILABLE_IN_2_40
570GVariant * g_variant_dict_end (GVariantDict *dict);
571GLIB_AVAILABLE_IN_2_40
572GVariantDict * g_variant_dict_ref (GVariantDict *dict);
573GLIB_AVAILABLE_IN_2_40
574void g_variant_dict_unref (GVariantDict *dict);
575
576G_END_DECLS
577
578#endif /* __G_VARIANT_H__ */
579