Class
JsonBuilder
Description [src]
class Json.Builder : GObject.Object {
/* No available fields */
}
JsonBuilder
provides an object for generating a JSON tree.
The root of the JSON tree can be either a JsonObject
or a JsonArray
.
Thus the first call must necessarily be either
json_builder_begin_object() or json_builder_begin_array().
For convenience to language bindings, most JsonBuilder
method return the
instance, making it easy to chain function calls.
Using JsonBuilder
g_autoptr(JsonBuilder) builder = json_builder_new ();
json_builder_begin_object (builder);
json_builder_set_member_name (builder, "url");
json_builder_add_string_value (builder, "http://www.gnome.org/img/flash/two-thirty.png");
json_builder_set_member_name (builder, "size");
json_builder_begin_array (builder);
json_builder_add_int_value (builder, 652);
json_builder_add_int_value (builder, 242);
json_builder_end_array (builder);
json_builder_end_object (builder);
g_autoptr(JsonNode) root root = json_builder_get_root (builder);
g_autoptr(JsonGenerator) gen = json_generator_new ();
json_generator_set_root (gen, root);
g_autofree char *str = json_generator_to_data (gen, NULL);
// str now contains the following JSON data
// { "url" : "http://www.gnome.org/img/flash/two-thirty.png", "size" : [ 652, 242 ] }
Constructors
json_builder_new
Creates a new JsonBuilder
.
Instance methods
json_builder_add_boolean_value
Adds a boolean value to the currently open object member or array.
json_builder_add_double_value
Adds a floating point value to the currently open object member or array.
json_builder_add_int_value
Adds an integer value to the currently open object member or array.
json_builder_add_null_value
Adds a null value to the currently open object member or array.
json_builder_add_string_value
Adds a boolean value to the currently open object member or array.
json_builder_add_value
Adds a value to the currently open object member or array.
json_builder_begin_array
Opens an array inside the given builder.
json_builder_begin_object
Opens an object inside the given builder.
json_builder_end_array
Closes the array inside the given builder that was opened by the most recent call to json_builder_begin_array().
json_builder_end_object
Closes the object inside the given builder that was opened by the most recent call to json_builder_begin_object().
json_builder_get_root
Returns the root of the currently constructed tree.
json_builder_reset
Resets the state of the builder back to its initial state.
json_builder_set_member_name
Sets the name of the member in an object.