Json

Description:

Content:

Interfaces:

Serializable - Interface that allows serializing and deserializing Objects with properties storing complex data types. The serialize_gobject function will check if the passed Object implements this interface, so it can also be used to override the default property serialization sequence.

Classes:

Array - A JSON array type. The contents of the Array structure are private and should only be accessed by the provided API
Builder - The Builder structure contains only private data
Generator - Generator class
Node - A generic container of JSON data types. The contents of the Node structure are private and should only be accessed via the provided functions and never directly.
Object - A JSON object type. The contents of the Object structure are private and should only be accessed by the provided API
Parser - Parser class.
Path - The Path structure is an opaque object class whose members cannot be directly accessed.
Reader - The Reader structure contains only private data

Enums:

NodeType - Indicates the content of a Node.
ParserError - Error enumeration for Parser
PathError - Error code enumeration for the PathError domain.
ReaderError - Error codes enumeration for Reader errors

Constants:

public const int MAJOR_VERSION
public const int MICRO_VERSION
public const int MINOR_VERSION
public const int VERSION_HEX
public const unowned string VERSION_S

Delegates:

public delegate void ArrayForeach (Array array, uint index_, Node element_node)
public delegate void* BoxedDeserializeFunc (Node node)
public delegate Node BoxedSerializeFunc (void* boxed)
public delegate void ObjectForeach (Object object, string member_name, Node member_node)

Functions:

public bool boxed_can_deserialize (Type gboxed_type, NodeType node_type)
Checks whether it is possible to deserialize a GBoxed of type gboxed_type from a Node of type node_type
public bool boxed_can_serialize (Type gboxed_type, out NodeType node_type)
Checks whether it is possible to serialize a GBoxed of type gboxed_type into a Node. The type of the Node is placed inside node_type if the function returns true and it's undefined otherwise.
public void* boxed_deserialize (Type gboxed_type, Node node)
Deserializes node into a GBoxed of gboxed_type
public void boxed_register_deserialize_func (Type gboxed_type, NodeType node_type, BoxedDeserializeFunc deserialize_func)
Registers a deserialization function for a GBoxed of type gboxed_type from a Node of type node_type
public void boxed_register_serialize_func (Type gboxed_type, NodeType node_type, BoxedSerializeFunc serialize_func)
Registers a serialization function for a GBoxed of type gboxed_type to a Node of type node_type
public Node boxed_serialize (Type gboxed_type, void* boxed)
Serializes boxed, a pointer to a GBoxed of type gboxed_type, into a Node
public Object construct_gobject (Type gtype, string data, size_t length) throws Error
Deserializes a JSON data stream and creates the corresponding Object class. If gtype implements the Serializable interface, it will be asked to deserialize all the JSON members into the respective properties; otherwise, the default implementation will be used to translate the compatible JSON native types.
public Object gobject_deserialize (Type gtype, Node node)
Creates a new Object of type gtype, and constructs it using the members of the passed Object
public Object gobject_from_data (Type gtype, string data, ssize_t length = -1) throws Error
Deserializes a JSON data stream and creates the corresponding Object class. If gtype implements the Serializable interface, it will be asked to deserialize all the JSON members into the respective properties; otherwise, the default implementation will be used to translate the compatible JSON native types.
public Node gobject_serialize (Object gobject)
Creates a Node representing the passed Object instance. Each member of the returned JSON object will map to a property of the Object
public string gobject_to_data (Object gobject, out size_t length)
Serializes a Object into a JSON data stream, iterating recursively over each property.
public Variant gvariant_deserialize (Node json_node, string? signature) throws Error
Converts a JSON data structure to a GVariant value using signature to resolve ambiguous data types. If no error occurs, the resulting Variant is guaranteed to conform to signature.
public Variant gvariant_deserialize_data (string json, ssize_t length, string? signature) throws Error
Converts a JSON string to a Variant value. This method works exactly like gvariant_deserialize, but takes a JSON encoded string instead. The string is first converted to a Node using Parser, and then gvariant_deserialize is called.
public Node gvariant_serialize (Variant variant)
Converts variant to a JSON tree.
public string gvariant_serialize_data (Variant variant, out size_t length)
Converts variant to its JSON encoded string representation. This method is actually a helper function. It uses gvariant_serialize to obtain the JSON tree, and then Generator to stringify it.
public string serialize_gobject (Object gobject, out size_t length)
Serializes a Object into a JSON data stream. If gobject implements the Serializable interface, it will be asked to serizalize all its properties; otherwise, the default implementation will be use to translate the compatible types into JSON native types.