gvariant.h 30 KB

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