]> mj.ucw.cz Git - libucw.git/blob - ucw-json/json.h
JSON: More parsing and formatting details
[libucw.git] / ucw-json / json.h
1 /*
2  *      UCW JSON Library
3  *
4  *      (c) 2015 Martin Mares <mj@ucw.cz>
5  *
6  *      This software may be freely distributed and used according to the terms
7  *      of the GNU Lesser General Public License.
8  */
9
10 #ifndef _UCW_JSON_JSON_H
11 #define _UCW_JSON_JSON_H
12
13 #include <ucw/clists.h>
14 #include <ucw/slists.h>
15 #include <ucw/mempool.h>
16 #include <ucw/fastbuf.h>
17
18 #ifdef CONFIG_UCW_CLEAN_ABI
19 // FIXME
20 #endif
21
22 /***
23  * === FIXME
24  ***/
25
26 struct json_context {
27   struct mempool *pool;
28   struct mempool_state init_state;
29   // FIXME: Size limit?
30
31   struct fastbuf *in_fb;
32   uint in_line;
33   bool in_eof;
34   struct json_node *next_token;
35   struct json_node *trivial_token;
36   int next_char;
37
38   struct fastbuf *out_fb;
39   uint out_indent;
40   uint format_options;          // Public
41 };
42
43 struct json_context *json_new(void);
44 void json_delete(struct json_context *js);
45 void json_reset(struct json_context *js);
46
47 enum json_node_type {
48   JSON_INVALID,
49   JSON_NULL,
50   JSON_BOOLEAN,
51   JSON_NUMBER,
52   JSON_STRING,
53   JSON_ARRAY,
54   JSON_OBJECT,
55   // These are not real nodes, but raw tokens
56   JSON_BEGIN_ARRAY,
57   JSON_END_ARRAY,
58   JSON_BEGIN_OBJECT,
59   JSON_END_OBJECT,
60   JSON_NAME_SEP,
61   JSON_VALUE_SEP,
62   JSON_EOF,
63 };
64
65 struct json_node {
66   enum json_node_type type;
67   union {
68     bool boolean;
69     double number;
70     const char *string;
71     struct json_node **elements;        // Growing array
72     struct json_pair *pairs;            // Growing array
73   };
74 };
75
76 struct json_pair {
77   const char *key;
78   struct json_node *value;
79   // FIXME: Hash table
80 };
81
82 struct json_node *json_new_node(struct json_context *js, enum json_node_type type);
83
84 static inline struct json_node *json_new_null(struct json_context *js)
85 {
86   return json_new_node(js, JSON_NULL);
87 }
88
89 static inline struct json_node *json_new_bool(struct json_context *js, bool value)
90 {
91   struct json_node *n = json_new_node(js, JSON_BOOLEAN);
92   n->boolean = value;
93   return n;
94 }
95
96 static inline struct json_node *json_new_number(struct json_context *js, double value)
97 {
98   struct json_node *n = json_new_node(js, JSON_NUMBER);
99   n->number = value;
100   return n;
101 }
102
103 static inline struct json_node *json_new_string_ref(struct json_context *js, const char *value)
104 {
105   struct json_node *n = json_new_node(js, JSON_STRING);
106   n->string = value;
107   return n;
108 }
109
110 static inline struct json_node *json_new_string(struct json_context *js, const char *value)
111 {
112   return json_new_string_ref(js, mp_strdup(js->pool, value));
113 }
114
115 struct json_node *json_new_array(struct json_context *js);
116 void json_array_append(struct json_node *array, struct json_node *elt);
117
118 struct json_node *json_new_object(struct json_context *js);
119 // FIXME: key must not be freed
120 void json_object_set(struct json_node *n, const char *key, struct json_node *value);
121 struct json_node *json_object_get(struct json_node *n, const char *key);
122
123 void json_set_input(struct json_context *js, struct fastbuf *in);
124 struct json_node *json_peek_token(struct json_context *js);
125 struct json_node *json_next_token(struct json_context *js);
126
127 struct json_node *json_next_value(struct json_context *js);
128
129 struct json_node *json_parse(struct json_context *js, struct fastbuf *fb);
130
131 void json_set_output(struct json_context *js, struct fastbuf *fb);
132 void json_write_value(struct json_context *js, struct json_node *n);
133 void json_write(struct json_context *js, struct fastbuf *fb, struct json_node *n);
134
135 enum json_format_option {
136   JSON_FORMAT_ESCAPE_NONASCII = 1,
137   JSON_FORMAT_INDENT = 2,
138 };
139
140 #endif