json_reader_new ()

JsonReader *
json_reader_new (JsonNode *node);

Creates a new JsonReader. You can use this object to read the contents of the JSON tree starting from node

Since: 0.12

json_reader_set_root ()

void
json_reader_set_root (JsonReader *reader,
                      JsonNode *root);

Sets the root JsonNode to be read by reader . The reader will take a copy of root

If another JsonNode is currently set as root, it will be replaced.

Since: 0.12

json_reader_read_element ()

gboolean
json_reader_read_element (JsonReader *reader,
                          guint index_);

Advances the cursor of reader to the element index_ of the array or the object at the current position.

You can use the json_reader_get_value* family of functions to retrieve the value of the element; for instance:

1
2

json_reader_read_element (reader, 0);
int_value = json_reader_get_int_value (reader);

After reading the value, json_reader_end_element() should be called to reposition the cursor inside the JsonReader, e.g.:

1
2
3
4
5
6
7

json_reader_read_element (reader, 1);
str_value = json_reader_get_string_value (reader);
json_reader_end_element (reader);

json_reader_read_element (reader, 2);
str_value = json_reader_get_string_value (reader);
json_reader_end_element (reader);

If reader is not currently on an array or an object, or if the index_ is bigger than the size of the array or the object, the JsonReader will be put in an error state until json_reader_end_element() is called. This means that if used conditionally, json_reader_end_element() must be called on both code paths:

1
2
3
4
5
6
7
8
9

if (!json_reader_read_element (reader, 1))
  {
    json_reader_end_element (reader);
    g_set_error (error, …);
    return FALSE;
  }

str_value = json_reader_get_string_value (reader);
json_reader_end_element (reader);

Since: 0.12

json_reader_end_element ()

void
json_reader_end_element (JsonReader *reader);

Moves the cursor back to the previous node after being positioned inside an array

This function resets the error state of reader , if any was set

Since: 0.12

json_reader_is_array ()

gboolean
json_reader_is_array (JsonReader *reader);

Checks whether the reader is currently on an array

Since: 0.12

json_reader_count_elements ()

gint
json_reader_count_elements (JsonReader *reader);

Counts the elements of the current position, if reader is positioned on an array

Since: 0.12

json_reader_read_member ()

gboolean
json_reader_read_member (JsonReader *reader,
                         const gchar *member_name);

Advances the cursor of reader to the member_name of the object at the current position.

You can use the json_reader_get_value* family of functions to retrieve the value of the member; for instance:

1
2

json_reader_read_member (reader, "width");
width = json_reader_get_int_value (reader);

After reading the value, json_reader_end_member() should be called to reposition the cursor inside the JsonReader, e.g.:

1
2
3
4
5
6
7

json_reader_read_member (reader, "author");
author = json_reader_get_string_value (reader);
json_reader_end_member (reader);

json_reader_read_member (reader, "title");
title = json_reader_get_string_value (reader);
json_reader_end_member (reader);

If reader is not currently on an object, or if the member_name is not defined in the object, the JsonReader will be put in an error state until json_reader_end_member() is called. This means that if used conditionally, json_reader_end_member() must be called on both code paths:

1
2
3
4
5
6
7
8
9

if (!json_reader_read_member (reader, "title"))
  {
    json_reader_end_member (reader);
    g_set_error (error, …);
    return FALSE;
  }

str_value = json_reader_get_string_value (reader);
json_reader_end_member (reader);

Since: 0.12

json_reader_end_member ()

void
json_reader_end_member (JsonReader *reader);

Moves the cursor back to the previous node after being positioned inside an object

This function resets the error state of reader , if any was set

Since: 0.12

json_reader_is_object ()

gboolean
json_reader_is_object (JsonReader *reader);

Checks whether the reader is currently on an object

Since: 0.12

json_reader_count_members ()

gint
json_reader_count_members (JsonReader *reader);

Counts the members of the current position, if reader is positioned on an object

Since: 0.12

json_reader_list_members ()

gchar **
json_reader_list_members (JsonReader *reader);

Retrieves a list of member names from the current position, if reader is positioned on an object.

Since: 0.14

json_reader_get_member_name ()

const gchar *
json_reader_get_member_name (JsonReader *reader);

Retrieves the name of the current member.

Since: 0.14

json_reader_is_value ()

gboolean
json_reader_is_value (JsonReader *reader);

Checks whether the reader is currently on a value

Since: 0.12

json_reader_get_value ()

JsonNode *
json_reader_get_value (JsonReader *reader);

Retrieves the JsonNode of the current position of reader

Since: 0.12

json_reader_get_int_value ()

gint64
json_reader_get_int_value (JsonReader *reader);

Retrieves the integer value of the current position of reader

Since: 0.12

json_reader_get_double_value ()

gdouble
json_reader_get_double_value (JsonReader *reader);

Retrieves the floating point value of the current position of reader

Since: 0.12

json_reader_get_string_value ()

const gchar *
json_reader_get_string_value (JsonReader *reader);

Retrieves the string value of the current position of reader

Since: 0.12

json_reader_get_boolean_value ()

gboolean
json_reader_get_boolean_value (JsonReader *reader);

Retrieves the boolean value of the current position of reader

Since: 0.12

json_reader_get_null_value ()

gboolean
json_reader_get_null_value (JsonReader *reader);

Checks whether the value of the current position of reader is 'null'

Since: 0.12

json_reader_get_error ()

const GError *
json_reader_get_error (JsonReader *reader);

Retrieves the GError currently set on reader , if the JsonReader is in error state

Since: 0.12

struct JsonReader

struct JsonReader;

The JsonReader structure contains only private data and should be accessed using the provided API

Since: 0.12

struct JsonReaderClass

struct JsonReaderClass {
};

The JsonReaderClass structure contains only private data

Since: 0.12

enum JsonReaderError

Error codes enumeration for JsonReader errors

Since: 0.12

JSON_READER_ERROR

#define JSON_READER_ERROR               (json_reader_error_quark ())

Error domain for JsonReader errors

Since: 0.12

The “root” property

  “root”                     JsonNode *

The root of the JSON tree that the JsonReader should read.

Flags: Read / Write / Construct

Since: 0.12