gvariant_deserialize

Converts a JSON data structure to a `GVariant`.

If `signature` is not `NULL`, it will be used 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 the `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 the `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.

Example: GVariant deserialization:

public static int main (string[] args) {
	
	try {
		// Create a Node:
		// See Json.gvariant_deserialize_data
		string data = """{ "a" : 3, "b" : 4 }""";
		Json.Parser parser = new Json.Parser ();
		parser.load_from_data (data);
		Json.Node node = parser.get_root ();

		// Deserialization:
		Variant variant = Json.gvariant_deserialize (node, null);
		print (variant.print (true));
		print ("\n");
	} catch (Error e) {
		assert_not_reached ();
	}

	return 0;
}

valac --pkg json-glib-1.0 deserialization-variant.vala

Parameters:

json_node	the node to convert
signature	a valid `GVariant` type string

Returns:

A newly created `GVariant`