Function

Jsonconstruct_gobject

deprecated: 0.10 since: 0.4

Declaration [src]

GObject*
json_construct_gobject (
  GType gtype,
  const gchar* data,
  gsize length,
  GError** error
)

Description [src]

Deserializes a JSON data stream and creates an instance of the given type.

If the given type implements the JsonSerializable interface, it will be asked to deserialize all the JSON members into their respective properties; otherwise, the default implementation will be used to translate the compatible JSON native types.

Note: the JSON data stream must be an object.

For historical reasons, the length argument is unused. The given data must be a NUL-terminated string.

Available since: 0.4

Deprecated since: 0.10

Use json_gobject_from_data() instead.

Parameters

gtype

Type: GType

The type of the object to construct.

data

Type: const gchar*

A JSON data stream.

The data is owned by the caller of the function.
The value is a NUL terminated UTF-8 string.
length

Type: gsize

Length of the data stream (unused)

error

Type: GError **

The return location for a recoverable error.

The argument can be NULL.
If the return location is not NULL, then you must initialize it to a NULL GError*.
The argument will be left initialized to NULL by the function if there are no errors.
In case of error, the argument will be set to a newly allocated GError; the caller will take ownership of the data, and be responsible for freeing it.

Return value

Type: GObject

A new object instance of the given type.

The caller of the function takes ownership of the data, and is responsible for freeing it.
The return value can be NULL.