YAZ  5.23.1
Data Structures | Functions
json.c File Reference

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>

Go to the source code of this file.

Data Structures

struct  json_subst_info
 
struct  json_parser_s
 

Functions

json_parser_t json_parser_create (void)
 create JSON parser More...
 
void json_parser_subst (json_parser_t p, int idx, struct json_node *n)
 configure subst rule More...
 
void json_parser_destroy (json_parser_t p)
 destroys JSON parser More...
 
static int look_ch (json_parser_t p)
 
static void move_ch (json_parser_t p)
 
static struct json_nodejson_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 More...
 
static struct json_nodejson_parse_object (json_parser_t p)
 
static struct json_nodejson_parse_array (json_parser_t p)
 
static int json_one_char (const char **p, char *out)
 
static struct json_nodejson_parse_string (json_parser_t p)
 
static struct json_nodejson_parse_number (json_parser_t p)
 
static struct json_nodejson_parse_value (json_parser_t p)
 
static struct json_nodejson_parse_elements (json_parser_t p)
 
static struct json_nodejson_parse_pair (json_parser_t p)
 
static struct json_nodejson_parse_members (json_parser_t p)
 
struct json_nodejson_parser_parse (json_parser_t p, const char *json_str)
 parses JSON string More...
 
struct json_nodejson_parse2 (const char *json_str, const char **errmsg, size_t *pos)
 parses JSON string More...
 
struct json_nodejson_parse (const char *json_str, const char **errmsg)
 parses JSON string More...
 
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) More...
 
void json_write_wrbuf (struct json_node *node, WRBUF result)
 converts JSON tree to JSON string More...
 
static struct json_node ** json_get_objectp (struct json_node *n, const char *name)
 
struct json_nodejson_get_object (struct json_node *n, const char *name)
 gets object pair value for some name More...
 
struct json_nodejson_detach_object (struct json_node *n, const char *name)
 gets object value and detaches from existing tree More...
 
struct json_nodejson_get_elem (struct json_node *n, int idx)
 gets array element More...
 
int json_count_children (struct json_node *n)
 returns number of children (array or object) More...
 
int json_append_array (struct json_node *dst, struct json_node *src)
 appends array to another More...
 
const char * json_parser_get_errmsg (json_parser_t p)
 returns parser error More...
 
size_t json_parser_get_position (json_parser_t p)
 returns parser position More...
 

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
dstoriginal array and resulting array
srcarray to be appended to dst
Return values
-1not arrays
0array appended OK

Definition at line 723 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
nJSON node (presumably array node or object node)
Returns
number of children

Definition at line 711 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 
)

gets object value and detaches from existing tree

Parameters
nJSON node (presumably object node)
namename to match
Returns
node or NULL if not found

Definition at line 685 of file json.c.

References json_get_objectp().

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

gets array element

Parameters
nJSON node (presumably array node)
idx(0=first, 1=second, ..)
Returns
node or NULL if not found

Definition at line 698 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 
)

gets object pair value for some name

Parameters
nJSON node (presumably object node)
namename to match
Returns
node or NULL if not found

Definition at line 676 of file json.c.

References json_get_objectp().

static struct json_node** json_get_objectp ( struct json_node n,
const char *  name 
)
static
static void json_indent ( WRBUF  result,
int  indent 
)
static

Definition at line 558 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 
)
static
static int json_one_char ( const char **  p,
char *  out 
)
static

Definition at line 124 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 
)

parses JSON string

Parameters
json_strJSON string
errmsgpointer 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 553 of file json.c.

References json_parse2().

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

parses JSON string

Parameters
json_strJSON string
errmsgpointer to error message string
posposition 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 531 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)
static
static struct json_node* json_parse_elements ( json_parser_t  p)
static
static struct json_node* json_parse_members ( json_parser_t  p)
static
static struct json_node* json_parse_number ( json_parser_t  p)
static
static struct json_node * json_parse_object ( json_parser_t  p)
static
static struct json_node* json_parse_pair ( json_parser_t  p)
static
static struct json_node* json_parse_string ( json_parser_t  p)
static
static struct json_node* json_parse_value ( json_parser_t  p)
static
json_parser_t json_parser_create ( void  )

create JSON parser

Returns
JSON parser handle

Definition at line 38 of file json.c.

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

Referenced by json_parse2().

void json_parser_destroy ( json_parser_t  p)

destroys JSON parser

Parameters
pJSON parser handle

Definition at line 63 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
pJSON parser handle
Returns
parse error msg

This function should be called if json_parser_parse returns NULL .

Definition at line 739 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
pJSON parser handle
Returns
number of bytes read from parser

This function should be called if json_parser_parse returns NULL .

Definition at line 744 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 
)

parses JSON string

Parameters
pJSON parser handle
json_strJSON 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 503 of file json.c.

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

Referenced by json_parse2().

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

configure subst rule

Parameters
pJSON parser
idx(id)
nnode to be substituted for idx (idx)

Definition at line 48 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)
void json_write_wrbuf ( struct json_node node,
WRBUF  result 
)

converts JSON tree to JSON string

Parameters
nodeJSON tree
resultresulting JSON string buffer

Definition at line 654 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
nodeJSON tree
resultresulting JSON string buffer

Definition at line 649 of file json.c.

References json_write_wrbuf_r().

static void json_write_wrbuf_r ( struct json_node node,
WRBUF  result,
int  indent 
)
static
static int look_ch ( json_parser_t  p)
static
static void move_ch ( json_parser_t  p)
static