Strings

JSON strings map to GVariant (s).

Integers

JSON integers map to GVariant int64 (x).

Booleans

JSON booleans map to GVariant boolean (b).

Numbers

JSON numbers map to GVariant double (d).

Arrays

JSON arrays map to GVariant arrays of variants (av).

Objects

JSON objects map to GVariant dictionaries of string to variants (a{sv}).

Null values

JSON null values map to GVariant maybe variants (mv).

json_gvariant_serialize ()

JsonNode *
json_gvariant_serialize (GVariant *variant);

Converts variant to a JSON tree.

Since: 0.14

json_gvariant_serialize_data ()

gchar *
json_gvariant_serialize_data (GVariant *variant,
                              gsize *length);

Converts variant to its JSON encoded string representation. This method is actually a helper function. It uses json_gvariant_serialize() to obtain the JSON tree, and then JsonGenerator to stringify it.

Since: 0.14

json_gvariant_deserialize ()

GVariant *
json_gvariant_deserialize (JsonNode *json_node,
                           const gchar *signature,
                           GError **error);

Converts a JSON data structure to a GVariant value using signature to resolve ambiguous data types. If no error occurs, the resulting GVariant is guaranteed to conform to signature .

If signature is not NULL but does not represent a valid GVariant type string, NULL is returned and error is set to G_IO_ERROR_INVALID_ARGUMENT. If a signature is provided but the JSON structure cannot be mapped to it, NULL is returned and error is set to G_IO_ERROR_INVALID_DATA. If signature is NULL, the conversion is done based strictly on the types in the JSON nodes.

The returned variant has a floating reference that will need to be sunk by the caller code.

Since: 0.14

json_gvariant_deserialize_data ()

GVariant *
json_gvariant_deserialize_data (const gchar *json,
                                gssize length,
                                const gchar *signature,
                                GError **error);

Converts a JSON string to a GVariant value. This method works exactly like json_gvariant_deserialize(), but takes a JSON encoded string instead. The string is first converted to a JsonNode using JsonParser, and then json_gvariant_deserialize() is called.

The returned variant has a floating reference that will need to be sunk by the caller code.

Since: 0.14