2 * Copyright © 2007, 2008 Ryan Lortie
3 * Copyright © 2009, 2010 Codethink Limited
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 licence, or (at your option) any later version.
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.
15 * You should have received a copy of the GNU Lesser General Public
16 * License along with this library; if not, see <http://www.gnu.org/licenses/>.
18 * Author: Ryan Lortie <desrt@desrt.ca>
21 #ifndef __G_VARIANT_H__
22 #define __G_VARIANT_H__
24 #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION)
25 #error "Only <glib.h> can be included directly."
28 #include <glib/gvarianttype.h>
29 #include <glib/gstring.h>
30 #include <glib/gbytes.h>
34 typedef struct _GVariant GVariant;
38 G_VARIANT_CLASS_BOOLEAN = 'b',
39 G_VARIANT_CLASS_BYTE = 'y',
40 G_VARIANT_CLASS_INT16 = 'n',
41 G_VARIANT_CLASS_UINT16 = 'q',
42 G_VARIANT_CLASS_INT32 = 'i',
43 G_VARIANT_CLASS_UINT32 = 'u',
44 G_VARIANT_CLASS_INT64 = 'x',
45 G_VARIANT_CLASS_UINT64 = 't',
46 G_VARIANT_CLASS_HANDLE = 'h',
47 G_VARIANT_CLASS_FLOAT = 'f',
48 G_VARIANT_CLASS_DOUBLE = 'd',
49 G_VARIANT_CLASS_STRING = 's',
50 G_VARIANT_CLASS_OBJECT_PATH = 'o',
51 G_VARIANT_CLASS_SIGNATURE = 'g',
52 G_VARIANT_CLASS_VARIANT = 'v',
53 G_VARIANT_CLASS_MAYBE = 'm',
54 G_VARIANT_CLASS_ARRAY = 'a',
55 G_VARIANT_CLASS_TUPLE = '(',
56 G_VARIANT_CLASS_DICT_ENTRY = '{'
60 void g_variant_unref (GVariant *value);
62 GVariant * g_variant_ref (GVariant *value);
64 GVariant * g_variant_ref_sink (GVariant *value);
66 gboolean g_variant_is_floating (GVariant *value);
68 GVariant * g_variant_take_ref (GVariant *value);
71 const GVariantType * g_variant_get_type (GVariant *value);
73 const gchar * g_variant_get_type_string (GVariant *value);
75 gboolean g_variant_is_of_type (GVariant *value,
76 const GVariantType *type);
78 gboolean g_variant_is_container (GVariant *value);
80 GVariantClass g_variant_classify (GVariant *value);
82 GVariant * g_variant_new_boolean (gboolean value);
84 GVariant * g_variant_new_byte (guchar value);
86 GVariant * g_variant_new_int16 (gint16 value);
88 GVariant * g_variant_new_uint16 (guint16 value);
90 GVariant * g_variant_new_int32 (gint32 value);
92 GVariant * g_variant_new_uint32 (guint32 value);
94 GVariant * g_variant_new_int64 (gint64 value);
96 GVariant * g_variant_new_uint64 (guint64 value);
98 GVariant * g_variant_new_handle (gint32 value);
99 GLIB_AVAILABLE_IN_2_44
100 GVariant * g_variant_new_float (gfloat value);
101 GLIB_AVAILABLE_IN_ALL
102 GVariant * g_variant_new_double (gdouble value);
103 GLIB_AVAILABLE_IN_ALL
104 GVariant * g_variant_new_string (const gchar *string);
105 GLIB_AVAILABLE_IN_2_38
106 GVariant * g_variant_new_take_string (gchar *string);
107 GLIB_AVAILABLE_IN_2_38
108 GVariant * g_variant_new_printf (const gchar *format_string,
109 ...) G_GNUC_PRINTF (1, 2);
110 GLIB_AVAILABLE_IN_ALL
111 GVariant * g_variant_new_object_path (const gchar *object_path);
112 GLIB_AVAILABLE_IN_ALL
113 gboolean g_variant_is_object_path (const gchar *string);
114 GLIB_AVAILABLE_IN_ALL
115 GVariant * g_variant_new_signature (const gchar *signature);
116 GLIB_AVAILABLE_IN_ALL
117 gboolean g_variant_is_signature (const gchar *string);
118 GLIB_AVAILABLE_IN_ALL
119 GVariant * g_variant_new_variant (GVariant *value);
120 GLIB_AVAILABLE_IN_ALL
121 GVariant * g_variant_new_strv (const gchar * const *strv,
123 GLIB_AVAILABLE_IN_2_30
124 GVariant * g_variant_new_objv (const gchar * const *strv,
126 GLIB_AVAILABLE_IN_ALL
127 GVariant * g_variant_new_bytestring (const gchar *string);
128 GLIB_AVAILABLE_IN_ALL
129 GVariant * g_variant_new_bytestring_array (const gchar * const *strv,
131 GLIB_AVAILABLE_IN_ALL
132 GVariant * g_variant_new_fixed_array (const GVariantType *element_type,
133 gconstpointer elements,
136 GLIB_AVAILABLE_IN_ALL
137 gboolean g_variant_get_boolean (GVariant *value);
138 GLIB_AVAILABLE_IN_ALL
139 guchar g_variant_get_byte (GVariant *value);
140 GLIB_AVAILABLE_IN_ALL
141 gint16 g_variant_get_int16 (GVariant *value);
142 GLIB_AVAILABLE_IN_ALL
143 guint16 g_variant_get_uint16 (GVariant *value);
144 GLIB_AVAILABLE_IN_ALL
145 gint32 g_variant_get_int32 (GVariant *value);
146 GLIB_AVAILABLE_IN_ALL
147 guint32 g_variant_get_uint32 (GVariant *value);
148 GLIB_AVAILABLE_IN_ALL
149 gint64 g_variant_get_int64 (GVariant *value);
150 GLIB_AVAILABLE_IN_ALL
151 guint64 g_variant_get_uint64 (GVariant *value);
152 GLIB_AVAILABLE_IN_ALL
153 gint32 g_variant_get_handle (GVariant *value);
154 GLIB_AVAILABLE_IN_2_44
155 gfloat g_variant_get_float (GVariant *value);
156 GLIB_AVAILABLE_IN_ALL
157 gdouble g_variant_get_double (GVariant *value);
158 GLIB_AVAILABLE_IN_ALL
159 GVariant * g_variant_get_variant (GVariant *value);
160 GLIB_AVAILABLE_IN_ALL
161 const gchar * g_variant_get_string (GVariant *value,
163 GLIB_AVAILABLE_IN_ALL
164 gchar * g_variant_dup_string (GVariant *value,
166 GLIB_AVAILABLE_IN_ALL
167 const gchar ** g_variant_get_strv (GVariant *value,
169 GLIB_AVAILABLE_IN_ALL
170 gchar ** g_variant_dup_strv (GVariant *value,
172 GLIB_AVAILABLE_IN_2_30
173 const gchar ** g_variant_get_objv (GVariant *value,
175 GLIB_AVAILABLE_IN_ALL
176 gchar ** g_variant_dup_objv (GVariant *value,
178 GLIB_AVAILABLE_IN_ALL
179 const gchar * g_variant_get_bytestring (GVariant *value);
180 GLIB_AVAILABLE_IN_ALL
181 gchar * g_variant_dup_bytestring (GVariant *value,
183 GLIB_AVAILABLE_IN_ALL
184 const gchar ** g_variant_get_bytestring_array (GVariant *value,
186 GLIB_AVAILABLE_IN_ALL
187 gchar ** g_variant_dup_bytestring_array (GVariant *value,
190 GLIB_AVAILABLE_IN_ALL
191 GVariant * g_variant_new_maybe (const GVariantType *child_type,
193 GLIB_AVAILABLE_IN_ALL
194 GVariant * g_variant_new_array (const GVariantType *child_type,
195 GVariant * const *children,
197 GLIB_AVAILABLE_IN_ALL
198 GVariant * g_variant_new_tuple (GVariant * const *children,
200 GLIB_AVAILABLE_IN_ALL
201 GVariant * g_variant_new_dict_entry (GVariant *key,
204 GLIB_AVAILABLE_IN_ALL
205 GVariant * g_variant_get_maybe (GVariant *value);
206 GLIB_AVAILABLE_IN_ALL
207 gsize g_variant_n_children (GVariant *value);
208 GLIB_AVAILABLE_IN_ALL
209 void g_variant_get_child (GVariant *value,
211 const gchar *format_string,
213 GLIB_AVAILABLE_IN_ALL
214 GVariant * g_variant_get_child_value (GVariant *value,
216 GLIB_AVAILABLE_IN_ALL
217 gboolean g_variant_lookup (GVariant *dictionary,
219 const gchar *format_string,
221 GLIB_AVAILABLE_IN_ALL
222 GVariant * g_variant_lookup_value (GVariant *dictionary,
224 const GVariantType *expected_type);
225 GLIB_AVAILABLE_IN_ALL
226 gconstpointer g_variant_get_fixed_array (GVariant *value,
230 GLIB_AVAILABLE_IN_ALL
231 gsize g_variant_get_size (GVariant *value);
232 GLIB_AVAILABLE_IN_ALL
233 gconstpointer g_variant_get_data (GVariant *value);
234 GLIB_AVAILABLE_IN_2_36
235 GBytes * g_variant_get_data_as_bytes (GVariant *value);
236 GLIB_AVAILABLE_IN_ALL
237 void g_variant_store (GVariant *value,
240 GLIB_AVAILABLE_IN_ALL
241 gchar * g_variant_print (GVariant *value,
242 gboolean type_annotate);
243 GLIB_AVAILABLE_IN_ALL
244 GString * g_variant_print_string (GVariant *value,
246 gboolean type_annotate);
248 GLIB_AVAILABLE_IN_ALL
249 guint g_variant_hash (gconstpointer value);
250 GLIB_AVAILABLE_IN_ALL
251 gboolean g_variant_equal (gconstpointer one,
254 GLIB_AVAILABLE_IN_ALL
255 GVariant * g_variant_get_normal_form (GVariant *value);
256 GLIB_AVAILABLE_IN_ALL
257 gboolean g_variant_is_normal_form (GVariant *value);
258 GLIB_AVAILABLE_IN_ALL
259 GVariant * g_variant_byteswap (GVariant *value);
261 GLIB_AVAILABLE_IN_2_36
262 GVariant * g_variant_new_from_bytes (const GVariantType *type,
265 GLIB_AVAILABLE_IN_ALL
266 GVariant * g_variant_new_from_data (const GVariantType *type,
270 GDestroyNotify notify,
273 typedef struct _GVariantIter GVariantIter;
274 struct _GVariantIter {
279 GLIB_AVAILABLE_IN_ALL
280 GVariantIter * g_variant_iter_new (GVariant *value);
281 GLIB_AVAILABLE_IN_ALL
282 gsize g_variant_iter_init (GVariantIter *iter,
284 GLIB_AVAILABLE_IN_ALL
285 GVariantIter * g_variant_iter_copy (GVariantIter *iter);
286 GLIB_AVAILABLE_IN_ALL
287 gsize g_variant_iter_n_children (GVariantIter *iter);
288 GLIB_AVAILABLE_IN_ALL
289 void g_variant_iter_free (GVariantIter *iter);
290 GLIB_AVAILABLE_IN_ALL
291 GVariant * g_variant_iter_next_value (GVariantIter *iter);
292 GLIB_AVAILABLE_IN_ALL
293 gboolean g_variant_iter_next (GVariantIter *iter,
294 const gchar *format_string,
296 GLIB_AVAILABLE_IN_ALL
297 gboolean g_variant_iter_loop (GVariantIter *iter,
298 const gchar *format_string,
302 typedef struct _GVariantBuilder GVariantBuilder;
303 struct _GVariantBuilder {
310 G_VARIANT_PARSE_ERROR_FAILED,
311 G_VARIANT_PARSE_ERROR_BASIC_TYPE_EXPECTED,
312 G_VARIANT_PARSE_ERROR_CANNOT_INFER_TYPE,
313 G_VARIANT_PARSE_ERROR_DEFINITE_TYPE_EXPECTED,
314 G_VARIANT_PARSE_ERROR_INPUT_NOT_AT_END,
315 G_VARIANT_PARSE_ERROR_INVALID_CHARACTER,
316 G_VARIANT_PARSE_ERROR_INVALID_FORMAT_STRING,
317 G_VARIANT_PARSE_ERROR_INVALID_OBJECT_PATH,
318 G_VARIANT_PARSE_ERROR_INVALID_SIGNATURE,
319 G_VARIANT_PARSE_ERROR_INVALID_TYPE_STRING,
320 G_VARIANT_PARSE_ERROR_NO_COMMON_TYPE,
321 G_VARIANT_PARSE_ERROR_NUMBER_OUT_OF_RANGE,
322 G_VARIANT_PARSE_ERROR_NUMBER_TOO_BIG,
323 G_VARIANT_PARSE_ERROR_TYPE_ERROR,
324 G_VARIANT_PARSE_ERROR_UNEXPECTED_TOKEN,
325 G_VARIANT_PARSE_ERROR_UNKNOWN_KEYWORD,
326 G_VARIANT_PARSE_ERROR_UNTERMINATED_STRING_CONSTANT,
327 G_VARIANT_PARSE_ERROR_VALUE_EXPECTED
328 } GVariantParseError;
329 #define G_VARIANT_PARSE_ERROR (g_variant_parse_error_quark ())
331 GLIB_DEPRECATED_IN_2_38_FOR(g_variant_parse_error_quark)
332 GQuark g_variant_parser_get_error_quark (void);
334 GLIB_AVAILABLE_IN_ALL
335 GQuark g_variant_parse_error_quark (void);
337 GLIB_AVAILABLE_IN_ALL
338 GVariantBuilder * g_variant_builder_new (const GVariantType *type);
339 GLIB_AVAILABLE_IN_ALL
340 void g_variant_builder_unref (GVariantBuilder *builder);
341 GLIB_AVAILABLE_IN_ALL
342 GVariantBuilder * g_variant_builder_ref (GVariantBuilder *builder);
343 GLIB_AVAILABLE_IN_ALL
344 void g_variant_builder_init (GVariantBuilder *builder,
345 const GVariantType *type);
346 GLIB_AVAILABLE_IN_ALL
347 GVariant * g_variant_builder_end (GVariantBuilder *builder);
348 GLIB_AVAILABLE_IN_ALL
349 void g_variant_builder_clear (GVariantBuilder *builder);
350 GLIB_AVAILABLE_IN_ALL
351 void g_variant_builder_open (GVariantBuilder *builder,
352 const GVariantType *type);
353 GLIB_AVAILABLE_IN_ALL
354 void g_variant_builder_close (GVariantBuilder *builder);
355 GLIB_AVAILABLE_IN_ALL
356 void g_variant_builder_add_value (GVariantBuilder *builder,
358 GLIB_AVAILABLE_IN_ALL
359 void g_variant_builder_add (GVariantBuilder *builder,
360 const gchar *format_string,
362 GLIB_AVAILABLE_IN_ALL
363 void g_variant_builder_add_parsed (GVariantBuilder *builder,
367 GLIB_AVAILABLE_IN_ALL
368 GVariant * g_variant_new (const gchar *format_string,
370 GLIB_AVAILABLE_IN_ALL
371 void g_variant_get (GVariant *value,
372 const gchar *format_string,
374 GLIB_AVAILABLE_IN_ALL
375 GVariant * g_variant_new_va (const gchar *format_string,
376 const gchar **endptr,
378 GLIB_AVAILABLE_IN_ALL
379 void g_variant_get_va (GVariant *value,
380 const gchar *format_string,
381 const gchar **endptr,
383 GLIB_AVAILABLE_IN_2_34
384 gboolean g_variant_check_format_string (GVariant *value,
385 const gchar *format_string,
388 GLIB_AVAILABLE_IN_ALL
389 GVariant * g_variant_parse (const GVariantType *type,
392 const gchar **endptr,
394 GLIB_AVAILABLE_IN_ALL
395 GVariant * g_variant_new_parsed (const gchar *format,
397 GLIB_AVAILABLE_IN_ALL
398 GVariant * g_variant_new_parsed_va (const gchar *format,
401 GLIB_AVAILABLE_IN_2_40
402 gchar * g_variant_parse_error_print_context (GError *error,
403 const gchar *source_str);
405 GLIB_AVAILABLE_IN_ALL
406 gint g_variant_compare (gconstpointer one,
409 typedef struct _GVariantDict GVariantDict;
410 struct _GVariantDict {
415 GLIB_AVAILABLE_IN_2_40
416 GVariantDict * g_variant_dict_new (GVariant *from_asv);
418 GLIB_AVAILABLE_IN_2_40
419 void g_variant_dict_init (GVariantDict *dict,
422 GLIB_AVAILABLE_IN_2_40
423 gboolean g_variant_dict_lookup (GVariantDict *dict,
425 const gchar *format_string,
427 GLIB_AVAILABLE_IN_2_40
428 GVariant * g_variant_dict_lookup_value (GVariantDict *dict,
430 const GVariantType *expected_type);
431 GLIB_AVAILABLE_IN_2_40
432 gboolean g_variant_dict_contains (GVariantDict *dict,
434 GLIB_AVAILABLE_IN_2_40
435 void g_variant_dict_insert (GVariantDict *dict,
437 const gchar *format_string,
439 GLIB_AVAILABLE_IN_2_40
440 void g_variant_dict_insert_value (GVariantDict *dict,
443 GLIB_AVAILABLE_IN_2_40
444 gboolean g_variant_dict_remove (GVariantDict *dict,
446 GLIB_AVAILABLE_IN_2_40
447 void g_variant_dict_clear (GVariantDict *dict);
448 GLIB_AVAILABLE_IN_2_40
449 GVariant * g_variant_dict_end (GVariantDict *dict);
450 GLIB_AVAILABLE_IN_2_40
451 GVariantDict * g_variant_dict_ref (GVariantDict *dict);
452 GLIB_AVAILABLE_IN_2_40
453 void g_variant_dict_unref (GVariantDict *dict);
457 #endif /* __G_VARIANT_H__ */