JSON encoding/decoding. More...

#include <yaz/json.h>
#include <stdlib.h>
#include <errno.h>
#include <string.h>
#include <assert.h>
#include <stdio.h>
#include <yaz/xmalloc.h>

Data Structures
struct	json_subst_info
struct	json_parser_s

Functions
json_parser_t	json_parser_create (void)
	create JSON parser
void	json_parser_subst (json_parser_t p, int idx, struct json_node *n)
	configure subst rule
void	json_parser_destroy (json_parser_t p)
	destroys JSON parser
static int	look_ch (json_parser_t p)
static void	move_ch (json_parser_t p)
static struct json_node *	json_new_node (json_parser_t p, enum json_node_type type)
void	json_remove_node (struct json_node *n)
	destroys JSON tree node and its children
static struct json_node *	json_parse_object (json_parser_t p)
static struct json_node *	json_parse_array (json_parser_t p)
static int	json_one_char (const char *p, char out)
static struct json_node *	json_parse_string (json_parser_t p)
static struct json_node *	json_parse_number (json_parser_t p)
static struct json_node *	json_parse_value (json_parser_t p)
static struct json_node *	json_parse_elements (json_parser_t p)
static struct json_node *	json_parse_pair (json_parser_t p)
static struct json_node *	json_parse_members (json_parser_t p)
struct json_node *	json_parser_parse (json_parser_t p, const char *json_str)
	parses JSON string
struct json_node *	json_parse2 (const char json_str, const char errmsg, size_t pos)
	parses JSON string
struct json_node *	json_parse (const char json_str, const char *errmsg)
	parses JSON string
static void	wrbuf_json_write (WRBUF b, const char *cp, size_t sz)
void	wrbuf_json_puts (WRBUF b, const char *str)
	writes JSON text to WRBUF with escaping
static void	json_indent (WRBUF result, int indent)
static void	json_write_wrbuf_r (struct json_node *node, WRBUF result, int indent)
void	json_write_wrbuf_pretty (struct json_node *node, WRBUF result)
	writes JSON tree with indentation (pretty print)
void	json_write_wrbuf (struct json_node *node, WRBUF result)
	converts JSON tree to JSON string
static struct json_node **	json_get_objectp (struct json_node n, const char name)
struct json_node *	json_get_object (struct json_node n, const char name)
	gets object pair value for some name
struct json_node *	json_detach_object (struct json_node n, const char name)
	gets object value and detaches from existing tree
struct json_node *	json_get_elem (struct json_node *n, int idx)
	gets array element
int	json_count_children (struct json_node *n)
	returns number of children (array or object)
int	json_append_array (struct json_node dst, struct json_node src)
	appends array to another
const char *	json_parser_get_errmsg (json_parser_t p)
	returns parser error
size_t	json_parser_get_position (json_parser_t p)
	returns parser position

Detailed Description

JSON encoding/decoding.

Definition in file json.c.

Function Documentation

int json_append_array	(	struct json_node *	dst,
		struct json_node *	src
	)

appends array to another

Parameters

dst	original array and resulting array
src	array to be appended to dst

Return values

-1	not arrays
0	array appended OK

Definition at line 670 of file json.c.

References json_node_array, json_remove_node(), json_node::link, json_node::type, and json_node::u.

int json_count_children ( struct json_node * n )

returns number of children (array or object)

Parameters

n	JSON node (presumably array node or object node)

Returns: number of children

Definition at line 658 of file json.c.

References json_node_array, json_node_object, json_node::link, json_node::type, and json_node::u.

struct json_node* json_detach_object	(	struct json_node *	n,
		const char *	name
	)

read

gets object value and detaches from existing tree

Parameters

n	JSON node (presumably object node)
name	name to match

Returns: node or NULL if not found

Definition at line 632 of file json.c.

References json_get_objectp().

struct json_node* json_get_elem	(	struct json_node *	n,
		int	idx
	)

read

gets array element

Parameters

n	JSON node (presumably array node)
idx	(0=first, 1=second, ..)

Returns: node or NULL if not found

Definition at line 645 of file json.c.

References json_node_array, json_node::link, json_node::type, and json_node::u.

struct json_node* json_get_object	(	struct json_node *	n,
		const char *	name
	)

read

gets object pair value for some name

Parameters

n	JSON node (presumably object node)
name	name to match

Returns: node or NULL if not found

Definition at line 623 of file json.c.

References json_get_objectp().

static struct json_node** json_get_objectp	(	struct json_node *	n,
		const char *	name
	)

staticread

Definition at line 606 of file json.c.

References json_node_object, json_node_pair, json_node_string, json_node::link, json_node::string, json_node::type, and json_node::u.

Referenced by json_detach_object(), and json_get_object().

static void json_indent	(	WRBUF	result,
		int	indent
	)

static

Definition at line 505 of file json.c.

References wrbuf_buf, wrbuf_len, and wrbuf_putc.

Referenced by json_write_wrbuf_r().

static struct json_node* json_new_node	(	json_parser_t	p,
		enum json_node_type	type
	)

staticread

Definition at line 87 of file json.c.

References json_node::link, type, json_node::type, json_node::u, and xmalloc.

Referenced by json_parse_array(), json_parse_elements(), json_parse_members(), json_parse_number(), json_parse_object(), json_parse_pair(), json_parse_string(), and json_parse_value().

static int json_one_char	(	const char **	p,
		char *	out
	)

static

Definition at line 123 of file json.c.

References yaz_write_UTF8_char().

Referenced by json_parse_string().

struct json_node* json_parse	(	const char *	json_str,
		const char **	errmsg
	)

read

parses JSON string

Parameters

json_str	JSON string
errmsg	pointer to error message string

Returns: JSON tree or NULL if parse error occurred.

The resulting tree should be removed with a call to json_remove_node. The errmsg may be NULL in which case the error message is not returned.

Definition at line 460 of file json.c.

References json_parse2().

struct json_node* json_parse2	(	const char *	json_str,
		const char **	errmsg,
		size_t *	pos
	)

read

parses JSON string

Parameters

json_str	JSON string
errmsg	pointer to error message string
pos	position of parser stop (probably error)

Returns: JSON tree or NULL if parse error occurred.

The resulting tree should be removed with a call to json_remove_node. The errmsg may be NULL in which case the error message is not returned.

Definition at line 438 of file json.c.

References json_parser_create(), json_parser_destroy(), json_parser_get_errmsg(), json_parser_get_position(), and json_parser_parse().

Referenced by json_parse().

static struct json_node * json_parse_array ( json_parser_t p )

staticread

Definition at line 312 of file json.c.

References json_parser_s::err_msg, json_new_node(), json_node_array, json_parse_elements(), json_remove_node(), json_node::link, look_ch(), move_ch(), and json_node::u.

Referenced by json_parse_value().

static struct json_node* json_parse_elements ( json_parser_t p )

staticread

Definition at line 285 of file json.c.

References json_new_node(), json_node_list, json_parse_value(), json_remove_node(), json_node::link, look_ch(), move_ch(), and json_node::u.

Referenced by json_parse_array().

static struct json_node* json_parse_members ( json_parser_t p )

staticread

Definition at line 360 of file json.c.

References json_new_node(), json_node_list, json_parse_pair(), json_remove_node(), json_node::link, look_ch(), move_ch(), and json_node::u.

Referenced by json_parse_object().

static struct json_node* json_parse_number ( json_parser_t p )

staticread

Definition at line 216 of file json.c.

References json_parser_s::cp, json_parser_s::err_msg, json_new_node(), json_node_number, look_ch(), json_node::number, and json_node::u.

Referenced by json_parse_value().

static struct json_node * json_parse_object ( json_parser_t p )

staticread

Definition at line 387 of file json.c.

References json_parser_s::err_msg, json_new_node(), json_node_object, json_parse_members(), json_remove_node(), json_node::link, look_ch(), move_ch(), and json_node::u.

Referenced by json_parse_value().

static struct json_node* json_parse_pair ( json_parser_t p )

staticread

Definition at line 335 of file json.c.

References json_parser_s::err_msg, json_new_node(), json_node_pair, json_parse_string(), json_parse_value(), json_remove_node(), json_node::link, look_ch(), move_ch(), and json_node::u.

Referenced by json_parse_members().

static struct json_node* json_parse_string ( json_parser_t p )

staticread

Definition at line 175 of file json.c.

References json_parser_s::cp, json_parser_s::err_msg, json_new_node(), json_node_string, json_one_char(), look_ch(), move_ch(), json_node::string, json_node::u, and xmalloc.

Referenced by json_parse_pair(), and json_parse_value().

static struct json_node* json_parse_value ( json_parser_t p )

staticread

Definition at line 236 of file json.c.

References json_parser_s::cp, json_parser_s::err_msg, json_subst_info::idx, json_new_node(), json_node_false, json_node_null, json_node_true, json_parse_array(), json_parse_number(), json_parse_object(), json_parse_string(), look_ch(), json_subst_info::next, json_subst_info::node, and json_parser_s::subst.

Referenced by json_parse_elements(), json_parse_pair(), and json_parser_parse().

json_parser_t json_parser_create ( void )

create JSON parser

Returns: JSON parser handle

Definition at line 36 of file json.c.

References json_parser_s::buf, json_parser_s::cp, json_parser_s::err_msg, json_parser_s::subst, and xmalloc.

Referenced by json_parse2().

void json_parser_destroy ( json_parser_t p )

destroys JSON parser

Parameters

p	JSON parser handle

Definition at line 62 of file json.c.

References json_subst_info::next, json_parser_s::subst, and xfree.

Referenced by json_parse2().

const char* json_parser_get_errmsg ( json_parser_t p )

returns parser error

Parameters

p	JSON parser handle

Returns: parse error msg

This function should be called if json_parser_parse returns NULL .

Definition at line 686 of file json.c.

References json_parser_s::err_msg.

Referenced by json_parse2().

size_t json_parser_get_position ( json_parser_t p )

returns parser position

Parameters

p	JSON parser handle

Returns: number of bytes read from parser

This function should be called if json_parser_parse returns NULL .

Definition at line 691 of file json.c.

References json_parser_s::buf, and json_parser_s::cp.

Referenced by json_parse2().

struct json_node* json_parser_parse	(	json_parser_t	p,
		const char *	json_str
	)

read

parses JSON string

Parameters

p	JSON parser handle
json_str	JSON string

Returns: JSON tree or NULL if parse error occurred.

The resulting tree should be removed with a call to json_remove_node.

Definition at line 418 of file json.c.

References json_parser_s::buf, json_parser_s::cp, json_parser_s::err_msg, json_parse_value(), json_remove_node(), and look_ch().

Referenced by json_parse2().

void json_parser_subst	(	json_parser_t	p,
		int	idx,
		struct json_node *	n
	)

configure subst rule

Parameters

p	JSON parser
idx	(id)
n	node to be substituted for idx (idx)

Definition at line 47 of file json.c.

References json_subst_info::idx, json_subst_info::next, json_subst_info::node, json_parser_s::subst, and xmalloc.

void json_remove_node ( struct json_node * n )

destroys JSON tree node and its children

Parameters

n JSON node

Definition at line 95 of file json.c.

References json_node_array, json_node_false, json_node_list, json_node_null, json_node_number, json_node_object, json_node_pair, json_node_string, json_node_true, json_remove_node(), json_node::link, json_node::string, json_node::type, json_node::u, and xfree.

Referenced by json_append_array(), json_parse_array(), json_parse_elements(), json_parse_members(), json_parse_object(), json_parse_pair(), json_parser_parse(), and json_remove_node().

void json_write_wrbuf	(	struct json_node *	node,
		WRBUF	result
	)

converts JSON tree to JSON string

Parameters

node	JSON tree
result	resulting JSON string buffer

Definition at line 601 of file json.c.

References json_write_wrbuf_r().

void json_write_wrbuf_pretty	(	struct json_node *	node,
		WRBUF	result
	)

writes JSON tree with indentation (pretty print)

Parameters

node	JSON tree
result	resulting JSON string buffer

Definition at line 596 of file json.c.

References json_write_wrbuf_r().

static void json_write_wrbuf_r	(	struct json_node *	node,
		WRBUF	result,
		int	indent
	)

static

Definition at line 516 of file json.c.

References json_indent(), json_node_array, json_node_false, json_node_list, json_node_null, json_node_number, json_node_object, json_node_pair, json_node_string, json_node_true, json_node::link, json_node::number, json_node::string, json_node::type, json_node::u, wrbuf_json_puts(), wrbuf_printf(), and wrbuf_puts().

Referenced by json_write_wrbuf(), and json_write_wrbuf_pretty().

static int look_ch ( json_parser_t p )

static

Definition at line 74 of file json.c.

References json_parser_s::cp.

Referenced by json_parse_array(), json_parse_elements(), json_parse_members(), json_parse_number(), json_parse_object(), json_parse_pair(), json_parse_string(), json_parse_value(), and json_parser_parse().

static void move_ch ( json_parser_t p )

static

Definition at line 81 of file json.c.

References json_parser_s::cp.

Referenced by json_parse_array(), json_parse_elements(), json_parse_members(), json_parse_object(), json_parse_pair(), and json_parse_string().

void wrbuf_json_puts	(	WRBUF	b,
		const char *	str
	)

writes JSON text to WRBUF with escaping

Parameters

b	result
str	input string to be encoded

Definition at line 500 of file json.c.

References wrbuf_json_write().

Referenced by json_write_wrbuf_r().

static void wrbuf_json_write	(	WRBUF	b,
		const char *	cp,
		size_t	sz
	)

static

Definition at line 465 of file json.c.

References wrbuf_printf(), and wrbuf_putc.

Referenced by wrbuf_json_puts().

Data Structures

Functions

Detailed Description

Function Documentation