2 * Copyright (c) 2009 Nicira Networks.
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at:
8 * http://www.apache.org/licenses/LICENSE-2.0
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
29 #include "dynamic-string.h"
35 /* The type of a JSON token. */
36 enum json_token_type {
42 T_NAME_SEPARATOR = ':',
43 T_VALUE_SEPARATOR = ',',
44 T_FALSE = UCHAR_MAX + 1,
54 * RFC 4627 doesn't define a lexical structure for JSON but I believe this to
55 * be compliant with the standard.
58 enum json_token_type type;
61 long long int integer;
67 JSON_LEX_START, /* Not inside a token. */
68 JSON_LEX_NUMBER, /* Reading a number. */
69 JSON_LEX_KEYWORD, /* Reading a keyword. */
70 JSON_LEX_STRING, /* Reading a quoted string. */
71 JSON_LEX_ESCAPE /* In a quoted string just after a "\". */
74 enum json_parse_state {
75 JSON_PARSE_START, /* Beginning of input. */
76 JSON_PARSE_END, /* End of input. */
79 JSON_PARSE_OBJECT_INIT, /* Expecting '}' or an object name. */
80 JSON_PARSE_OBJECT_NAME, /* Expecting an object name. */
81 JSON_PARSE_OBJECT_COLON, /* Expecting ':'. */
82 JSON_PARSE_OBJECT_VALUE, /* Expecting an object value. */
83 JSON_PARSE_OBJECT_NEXT, /* Expecting ',' or '}'. */
86 JSON_PARSE_ARRAY_INIT, /* Expecting ']' or a value. */
87 JSON_PARSE_ARRAY_VALUE, /* Expecting a value. */
88 JSON_PARSE_ARRAY_NEXT /* Expecting ',' or ']'. */
91 struct json_parser_node {
99 /* Lexical analysis. */
100 enum json_lex_state lex_state;
101 struct ds buffer; /* Buffer for accumulating token text. */
107 enum json_parse_state parse_state;
108 #define JSON_MAX_HEIGHT 1000
109 struct json_parser_node *stack;
110 size_t height, allocated_height;
115 char *error; /* Error message, if any, null if none yet. */
118 static struct json *json_create(enum json_type type);
119 static void json_parser_input(struct json_parser *, struct json_token *);
121 static void json_error(struct json_parser *p, const char *format, ...)
125 json_type_to_string(enum json_type type)
156 /* Functions for manipulating struct json. */
159 json_null_create(void)
161 return json_create(JSON_NULL);
165 json_boolean_create(bool b)
167 return json_create(b ? JSON_TRUE : JSON_FALSE);
171 json_string_create_nocopy(char *s)
173 struct json *json = json_create(JSON_STRING);
179 json_string_create(const char *s)
181 return json_string_create_nocopy(xstrdup(s));
185 json_array_create_empty(void)
187 struct json *json = json_create(JSON_ARRAY);
188 json->u.array.elems = NULL;
190 json->u.array.n_allocated = 0;
195 json_array_add(struct json *array_, struct json *element)
197 struct json_array *array = json_array(array_);
198 if (array->n >= array->n_allocated) {
199 array->elems = x2nrealloc(array->elems, &array->n_allocated,
200 sizeof *array->elems);
202 array->elems[array->n++] = element;
206 json_array_trim(struct json *array_)
208 struct json_array *array = json_array(array_);
209 if (array->n < array->n_allocated){
210 array->n_allocated = array->n;
211 array->elems = xrealloc(array->elems, array->n * sizeof *array->elems);
216 json_array_create(struct json **elements, size_t n)
218 struct json *json = json_create(JSON_ARRAY);
219 json->u.array.elems = elements;
221 json->u.array.n_allocated = n;
226 json_array_create_1(struct json *elem0)
228 struct json **elems = xmalloc(sizeof *elems);
230 return json_array_create(elems, 1);
234 json_array_create_2(struct json *elem0, struct json *elem1)
236 struct json **elems = xmalloc(2 * sizeof *elems);
239 return json_array_create(elems, 2);
243 json_array_create_3(struct json *elem0, struct json *elem1, struct json *elem2)
245 struct json **elems = xmalloc(3 * sizeof *elems);
249 return json_array_create(elems, 3);
253 json_object_create(void)
255 struct json *json = json_create(JSON_OBJECT);
256 json->u.object = xmalloc(sizeof *json->u.object);
257 shash_init(json->u.object);
262 json_integer_create(long long int integer)
264 struct json *json = json_create(JSON_INTEGER);
265 json->u.integer = integer;
270 json_real_create(double real)
272 struct json *json = json_create(JSON_REAL);
278 json_object_put(struct json *json, const char *name, struct json *value)
280 shash_add(json->u.object, name, value);
284 json_object_put_string(struct json *json, const char *name, const char *value)
286 json_object_put(json, name, json_string_create(value));
290 json_string(const struct json *json)
292 assert(json->type == JSON_STRING);
293 return json->u.string;
297 json_array(const struct json *json)
299 assert(json->type == JSON_ARRAY);
300 return (struct json_array *) &json->u.array;
304 json_object(const struct json *json)
306 assert(json->type == JSON_OBJECT);
307 return (struct shash *) json->u.object;
311 json_boolean(const struct json *json)
313 assert(json->type == JSON_TRUE || json->type == JSON_FALSE);
314 return json->type == JSON_TRUE;
318 json_real(const struct json *json)
320 assert(json->type == JSON_REAL || json->type == JSON_INTEGER);
321 return json->type == JSON_REAL ? json->u.real : json->u.integer;
325 json_integer(const struct json *json)
327 assert(json->type == JSON_INTEGER);
328 return json->u.integer;
331 static void json_destroy_object(struct shash *object);
332 static void json_destroy_array(struct json_array *array);
334 /* Frees 'json' and everything it points to, recursively. */
336 json_destroy(struct json *json)
339 switch (json->type) {
341 json_destroy_object(json->u.object);
345 json_destroy_array(&json->u.array);
349 free(json->u.string);
367 json_destroy_object(struct shash *object)
369 struct shash_node *node, *next;
371 SHASH_FOR_EACH_SAFE (node, next, object) {
372 struct json *value = node->data;
375 shash_delete(object, node);
377 shash_destroy(object);
382 json_destroy_array(struct json_array *array)
386 for (i = 0; i < array->n; i++) {
387 json_destroy(array->elems[i]);
392 static struct json *json_clone_object(const struct shash *object);
393 static struct json *json_clone_array(const struct json_array *array);
395 /* Returns a deep copy of 'json'. */
397 json_clone(const struct json *json)
399 switch (json->type) {
401 return json_clone_object(json->u.object);
404 return json_clone_array(&json->u.array);
407 return json_string_create(json->u.string);
412 return json_create(json->type);
415 return json_integer_create(json->u.integer);
418 return json_real_create(json->u.real);
427 json_clone_object(const struct shash *object)
429 struct shash_node *node;
432 json = json_object_create();
433 SHASH_FOR_EACH (node, object) {
434 struct json *value = node->data;
435 json_object_put(json, node->name, json_clone(value));
441 json_clone_array(const struct json_array *array)
446 elems = xmalloc(array->n * sizeof *elems);
447 for (i = 0; i < array->n; i++) {
448 elems[i] = json_clone(array->elems[i]);
450 return json_array_create(elems, array->n);
454 json_hash_object(const struct shash *object, size_t basis)
456 const struct shash_node **nodes;
459 nodes = shash_sort(object);
460 n = shash_count(object);
461 for (i = 0; i < n; i++) {
462 const struct shash_node *node = nodes[i];
463 basis = hash_string(node->name, basis);
464 basis = json_hash(node->data, basis);
470 json_hash_array(const struct json_array *array, size_t basis)
474 basis = hash_int(array->n, basis);
475 for (i = 0; i < array->n; i++) {
476 basis = json_hash(array->elems[i], basis);
482 json_hash(const struct json *json, size_t basis)
484 switch (json->type) {
486 return json_hash_object(json->u.object, basis);
489 return json_hash_array(&json->u.array, basis);
492 return hash_string(json->u.string, basis);
497 return hash_int(json->type << 8, basis);
500 return hash_int(json->u.integer, basis);
503 return hash_double(json->u.real, basis);
512 json_equal_object(const struct shash *a, const struct shash *b)
514 struct shash_node *a_node;
516 if (shash_count(a) != shash_count(b)) {
520 SHASH_FOR_EACH (a_node, a) {
521 struct shash_node *b_node = shash_find(b, a_node->name);
522 if (!b_node || !json_equal(a_node->data, b_node->data)) {
531 json_equal_array(const struct json_array *a, const struct json_array *b)
539 for (i = 0; i < a->n; i++) {
540 if (!json_equal(a->elems[i], b->elems[i])) {
549 json_equal(const struct json *a, const struct json *b)
551 if (a->type != b->type) {
557 return json_equal_object(a->u.object, b->u.object);
560 return json_equal_array(&a->u.array, &b->u.array);
563 return !strcmp(a->u.string, b->u.string);
571 return a->u.integer == b->u.integer;
574 return a->u.real == b->u.real;
582 /* Lexical analysis. */
585 json_lex_keyword(struct json_parser *p)
587 struct json_token token;
590 s = ds_cstr(&p->buffer);
591 if (!strcmp(s, "false")) {
592 token.type = T_FALSE;
593 } else if (!strcmp(s, "true")) {
595 } else if (!strcmp(s, "null")) {
598 json_error(p, "invalid keyword '%s'", s);
601 json_parser_input(p, &token);
605 json_lex_number(struct json_parser *p)
607 const char *cp = ds_cstr(&p->buffer);
608 unsigned long long int significand = 0;
609 struct json_token token;
611 bool imprecise = false;
612 bool negative = false;
615 /* Leading minus sign. */
621 /* At least one integer digit, but 0 may not be used as a leading digit for
622 * a longer number. */
628 json_error(p, "leading zeros not allowed");
631 } else if (isdigit(*cp)) {
633 if (significand <= ULLONG_MAX / 10) {
634 significand = significand * 10 + (*cp - '0');
643 } while (isdigit(*cp));
645 json_error(p, "'-' must be followed by digit");
649 /* Optional fraction. */
653 json_error(p, "decimal point must be followed by digit");
657 if (significand <= ULLONG_MAX / 10) {
658 significand = significand * 10 + (*cp - '0');
661 } else if (*cp != '0') {
665 } while (isdigit(*cp));
668 /* Optional exponent. */
669 if (*cp == 'e' || *cp == 'E') {
670 bool negative_exponent = false;
676 } else if (*cp == '-') {
677 negative_exponent = true;
682 json_error(p, "exponent must contain at least one digit");
688 if (exponent >= INT_MAX / 10) {
689 json_error(p, "exponent outside valid range");
692 exponent = exponent * 10 + (*cp - '0');
694 } while (isdigit(*cp));
696 if (negative_exponent) {
704 json_error(p, "syntax error in number");
708 /* Figure out number.
710 * We suppress negative zeros as a matter of policy. */
712 struct json_token token;
713 token.type = T_INTEGER;
715 json_parser_input(p, &token);
720 while (pow10 > 0 && significand < ULLONG_MAX / 10) {
725 while (pow10 < 0 && significand % 10 == 0) {
731 && significand <= (negative
732 ? (unsigned long long int) LLONG_MAX + 1
734 token.type = T_INTEGER;
735 token.u.integer = negative ? -significand : significand;
736 json_parser_input(p, &token);
742 if (!str_to_double(ds_cstr(&p->buffer), &token.u.real)) {
743 json_error(p, "number outside valid range");
746 /* Suppress negative zero. */
747 if (token.u.real == 0) {
750 json_parser_input(p, &token);
754 json_lex_4hex(struct json_parser *p, const char *cp, int *valuep)
759 for (i = 0; i < 4; i++) {
760 unsigned char c = *cp++;
762 json_error(p, "malformed \\u escape");
765 value = (value << 4) | hexit_value(c);
768 json_error(p, "null bytes not supported in quoted strings");
776 json_lex_unicode(struct json_parser *p, const char *cp, struct ds *s)
780 if (!json_lex_4hex(p, cp, &c0)) {
784 if (!uc_is_leading_surrogate(c0)) {
789 if (*cp++ != '\\' || *cp++ != 'u') {
790 json_error(p, "malformed escaped surrogate pair");
794 if (!json_lex_4hex(p, cp, &c1)) {
798 if (!uc_is_trailing_surrogate(c1)) {
799 json_error(p, "second half of escaped surrogate pair is not "
800 "trailing surrogate");
804 ds_put_utf8(s, utf16_decode_surrogate_pair(c0, c1));
809 json_lex_string(struct json_parser *p)
811 struct json_token token;
815 cp = ds_cstr(&p->buffer);
816 if (!strchr(cp, '\\')) {
817 token.type = T_STRING;
819 json_parser_input(p, &token);
824 ds_reserve(&s, strlen(cp));
825 while (*cp != '\0') {
827 ds_put_char(&s, *cp++);
833 case '"': case '\\': case '/':
834 ds_put_char(&s, cp[-1]);
838 ds_put_char(&s, '\b');
842 ds_put_char(&s, '\f');
846 ds_put_char(&s, '\n');
850 ds_put_char(&s, '\r');
854 ds_put_char(&s, '\t');
858 cp = json_lex_unicode(p, cp, &s);
865 json_error(p, "bad escape \\%c", cp[-1]);
870 token.type = T_STRING;
871 token.u.string = ds_cstr(&s);
872 json_parser_input(p, &token);
880 json_lex_input(struct json_parser *p, unsigned char c)
882 struct json_token token;
886 p->column_number = 0;
892 switch (p->lex_state) {
895 case ' ': case '\t': case '\n': case '\r':
899 case 'a': case 'b': case 'c': case 'd': case 'e':
900 case 'f': case 'g': case 'h': case 'i': case 'j':
901 case 'k': case 'l': case 'm': case 'n': case 'o':
902 case 'p': case 'q': case 'r': case 's': case 't':
903 case 'u': case 'v': case 'w': case 'x': case 'y':
905 p->lex_state = JSON_LEX_KEYWORD;
908 case '[': case '{': case ']': case '}': case ':': case ',':
910 json_parser_input(p, &token);
914 case '0': case '1': case '2': case '3': case '4':
915 case '5': case '6': case '7': case '8': case '9':
916 p->lex_state = JSON_LEX_NUMBER;
920 p->lex_state = JSON_LEX_STRING;
925 json_error(p, "invalid character '%c'", c);
927 json_error(p, "invalid character U+%04x", c);
933 case JSON_LEX_KEYWORD:
934 if (!isalpha((unsigned char) c)) {
940 case JSON_LEX_NUMBER:
941 if (!strchr(".0123456789eE-+", c)) {
947 case JSON_LEX_STRING:
949 p->lex_state = JSON_LEX_ESCAPE;
950 } else if (c == '"') {
953 } else if (c < 0x20) {
954 json_error(p, "U+%04X must be escaped in quoted string", c);
959 case JSON_LEX_ESCAPE:
960 p->lex_state = JSON_LEX_STRING;
966 ds_put_char(&p->buffer, c);
972 /* Parses 'string' as a JSON object or array and returns a newly allocated
973 * 'struct json'. The caller must free the returned structure with
974 * json_destroy() when it is no longer needed.
976 * 'string' must be encoded in UTF-8.
978 * If 'string' is valid JSON, then the returned 'struct json' will be either an
979 * object (JSON_OBJECT) or an array (JSON_ARRAY).
981 * If 'string' is not valid JSON, then the returned 'struct json' will be a
982 * string (JSON_STRING) that describes the particular error encountered during
983 * parsing. (This is an acceptable means of error reporting because at its top
984 * level JSON must be either an object or an array; a bare string is not
987 json_from_string(const char *string)
989 struct json_parser *p = json_parser_create(JSPF_TRAILER);
990 json_parser_feed(p, string, strlen(string));
991 return json_parser_finish(p);
994 /* Reads the file named 'file_name', parses its contents as a JSON object or
995 * array, and returns a newly allocated 'struct json'. The caller must free
996 * the returned structure with json_destroy() when it is no longer needed.
998 * The file must be encoded in UTF-8.
1000 * See json_from_string() for return value semantics.
1003 json_from_file(const char *file_name)
1008 stream = fopen(file_name, "r");
1010 return json_string_create_nocopy(
1011 xasprintf("error opening \"%s\": %s", file_name, strerror(errno)));
1013 json = json_from_stream(stream);
1019 /* Parses the contents of 'stream' as a JSON object or array, and returns a
1020 * newly allocated 'struct json'. The caller must free the returned structure
1021 * with json_destroy() when it is no longer needed.
1023 * The file must be encoded in UTF-8.
1025 * See json_from_string() for return value semantics.
1028 json_from_stream(FILE *stream)
1030 struct json_parser *p;
1033 p = json_parser_create(JSPF_TRAILER);
1035 char buffer[BUFSIZ];
1038 n = fread(buffer, 1, sizeof buffer, stream);
1039 if (!n || json_parser_feed(p, buffer, n) != n) {
1043 json = json_parser_finish(p);
1045 if (ferror(stream)) {
1047 json = json_string_create_nocopy(
1048 xasprintf("error reading JSON stream: %s", strerror(errno)));
1054 struct json_parser *
1055 json_parser_create(int flags)
1057 struct json_parser *p = xzalloc(sizeof *p);
1063 json_parser_feed(struct json_parser *p, const char *input, size_t n)
1066 for (i = 0; !p->done && i < n; ) {
1067 if (json_lex_input(p, input[i])) {
1075 json_parser_is_done(const struct json_parser *p)
1081 json_parser_finish(struct json_parser *p)
1085 switch (p->lex_state) {
1086 case JSON_LEX_START:
1089 case JSON_LEX_STRING:
1090 case JSON_LEX_ESCAPE:
1091 json_error(p, "unexpected end of input in quoted string");
1094 case JSON_LEX_NUMBER:
1095 case JSON_LEX_KEYWORD:
1096 json_lex_input(p, ' ');
1100 if (p->parse_state == JSON_PARSE_START) {
1101 json_error(p, "empty input stream");
1102 } else if (p->parse_state != JSON_PARSE_END) {
1103 json_error(p, "unexpected end of input");
1107 assert(p->height == 1);
1108 assert(p->stack[0].json != NULL);
1109 json = p->stack[--p->height].json;
1111 json = json_string_create_nocopy(p->error);
1115 json_parser_abort(p);
1121 json_parser_abort(struct json_parser *p)
1124 ds_destroy(&p->buffer);
1126 json_destroy(p->stack[0].json);
1129 free(p->member_name);
1135 static struct json_parser_node *
1136 json_parser_top(struct json_parser *p)
1138 return &p->stack[p->height - 1];
1142 json_parser_put_value(struct json_parser *p, struct json *value)
1144 struct json_parser_node *node = json_parser_top(p);
1145 if (node->json->type == JSON_OBJECT) {
1146 json_object_put(node->json, p->member_name, value);
1147 free(p->member_name);
1148 p->member_name = NULL;
1149 } else if (node->json->type == JSON_ARRAY) {
1150 json_array_add(node->json, value);
1156 static struct json_parser_node *
1157 json_parser_push(struct json_parser *p,
1158 struct json *new_json, enum json_parse_state new_state)
1160 if (p->height < JSON_MAX_HEIGHT) {
1161 struct json_parser_node *node;
1163 if (p->height >= p->allocated_height) {
1164 p->stack = x2nrealloc(p->stack, &p->allocated_height,
1168 if (p->height > 0) {
1169 json_parser_put_value(p, new_json);
1172 node = &p->stack[p->height++];
1173 node->json = new_json;
1174 p->parse_state = new_state;
1177 json_error(p, "input exceeds maximum nesting depth %d",
1184 json_parser_push_object(struct json_parser *p)
1186 json_parser_push(p, json_object_create(), JSON_PARSE_OBJECT_INIT);
1190 json_parser_push_array(struct json_parser *p)
1192 json_parser_push(p, json_array_create_empty(), JSON_PARSE_ARRAY_INIT);
1196 json_parse_value(struct json_parser *p, struct json_token *token,
1197 enum json_parse_state next_state)
1201 switch (token->type) {
1203 value = json_boolean_create(false);
1207 value = json_null_create();
1211 value = json_boolean_create(true);
1215 json_parser_push_object(p);
1219 json_parser_push_array(p);
1223 value = json_integer_create(token->u.integer);
1227 value = json_real_create(token->u.real);
1231 value = json_string_create(token->u.string);
1240 json_error(p, "syntax error expecting value");
1244 json_parser_put_value(p, value);
1245 p->parse_state = next_state;
1249 json_parser_pop(struct json_parser *p)
1251 struct json_parser_node *node;
1253 /* Conserve memory. */
1254 node = json_parser_top(p);
1255 if (node->json->type == JSON_ARRAY) {
1256 json_array_trim(node->json);
1259 /* Pop off the top-of-stack. */
1260 if (p->height == 1) {
1261 p->parse_state = JSON_PARSE_END;
1262 if (!(p->flags & JSPF_TRAILER)) {
1267 node = json_parser_top(p);
1268 if (node->json->type == JSON_ARRAY) {
1269 p->parse_state = JSON_PARSE_ARRAY_NEXT;
1270 } else if (node->json->type == JSON_OBJECT) {
1271 p->parse_state = JSON_PARSE_OBJECT_NEXT;
1279 json_parser_input(struct json_parser *p, struct json_token *token)
1281 switch (p->parse_state) {
1282 case JSON_PARSE_START:
1283 if (token->type == '{') {
1284 json_parser_push_object(p);
1285 } else if (token->type == '[') {
1286 json_parser_push_array(p);
1288 json_error(p, "syntax error at beginning of input");
1292 case JSON_PARSE_END:
1293 json_error(p, "trailing garbage at end of input");
1296 case JSON_PARSE_OBJECT_INIT:
1297 if (token->type == '}') {
1302 case JSON_PARSE_OBJECT_NAME:
1303 if (token->type == T_STRING) {
1304 p->member_name = xstrdup(token->u.string);
1305 p->parse_state = JSON_PARSE_OBJECT_COLON;
1307 json_error(p, "syntax error parsing object expecting string");
1311 case JSON_PARSE_OBJECT_COLON:
1312 if (token->type == ':') {
1313 p->parse_state = JSON_PARSE_OBJECT_VALUE;
1315 json_error(p, "syntax error parsing object expecting ':'");
1319 case JSON_PARSE_OBJECT_VALUE:
1320 json_parse_value(p, token, JSON_PARSE_OBJECT_NEXT);
1323 case JSON_PARSE_OBJECT_NEXT:
1324 if (token->type == ',') {
1325 p->parse_state = JSON_PARSE_OBJECT_NAME;
1326 } else if (token->type == '}') {
1329 json_error(p, "syntax error expecting '}' or ','");
1333 case JSON_PARSE_ARRAY_INIT:
1334 if (token->type == ']') {
1339 case JSON_PARSE_ARRAY_VALUE:
1340 json_parse_value(p, token, JSON_PARSE_ARRAY_NEXT);
1343 case JSON_PARSE_ARRAY_NEXT:
1344 if (token->type == ',') {
1345 p->parse_state = JSON_PARSE_ARRAY_VALUE;
1346 } else if (token->type == ']') {
1349 json_error(p, "syntax error expecting ']' or ','");
1357 p->lex_state = JSON_LEX_START;
1358 ds_clear(&p->buffer);
1361 static struct json *
1362 json_create(enum json_type type)
1364 struct json *json = xmalloc(sizeof *json);
1370 json_error(struct json_parser *p, const char *format, ...)
1377 ds_put_format(&msg, "line %d, column %d, byte %d: ",
1378 p->line_number, p->column_number, p->byte_number);
1379 va_start(args, format);
1380 ds_put_format_valist(&msg, format, args);
1383 p->error = ds_steal_cstr(&msg);
1389 #define SPACES_PER_LEVEL 2
1391 struct json_serializer {
1397 static void json_to_ds(const struct json *, struct json_serializer *);
1398 static void json_object_to_ds(const struct shash *object,
1399 struct json_serializer *);
1400 static void json_array_to_ds(const struct json_array *,
1401 struct json_serializer *);
1402 static void json_string_to_ds(const char *string, struct ds *);
1404 /* Converts 'json' to a string in JSON format, encoded in UTF-8, and returns
1405 * that string. The caller is responsible for freeing the returned string,
1406 * with free(), when it is no longer needed.
1408 * If 'flags' contains JSSF_PRETTY, the output is pretty-printed with each
1409 * nesting level introducing an additional indentation. Otherwise, the
1410 * returned string does not contain any new-line characters.
1412 * If 'flags' contains JSSF_SORT, members of objects in the output are sorted
1413 * in bytewise lexicographic order for reproducibility. Otherwise, members of
1414 * objects are output in an indeterminate order.
1416 * The returned string is valid JSON only if 'json' represents an array or an
1417 * object, since a bare literal does not satisfy the JSON grammar. */
1419 json_to_string(const struct json *json, int flags)
1421 struct json_serializer s;
1425 json_to_ds(json, &s);
1426 return ds_steal_cstr(&s.ds);
1430 json_to_ds(const struct json *json, struct json_serializer *s)
1432 struct ds *ds = &s->ds;
1434 switch (json->type) {
1436 ds_put_cstr(ds, "null");
1440 ds_put_cstr(ds, "false");
1444 ds_put_cstr(ds, "true");
1448 json_object_to_ds(json->u.object, s);
1452 json_array_to_ds(&json->u.array, s);
1456 ds_put_format(ds, "%lld", json->u.integer);
1460 ds_put_format(ds, "%.*g", DBL_DIG, json->u.real);
1464 json_string_to_ds(json->u.string, ds);
1474 indent_line(struct json_serializer *s)
1476 if (s->flags & JSSF_PRETTY) {
1477 ds_put_char(&s->ds, '\n');
1478 ds_put_char_multiple(&s->ds, ' ', SPACES_PER_LEVEL * s->depth);
1483 json_object_member_to_ds(size_t i, const struct shash_node *node,
1484 struct json_serializer *s)
1486 struct ds *ds = &s->ds;
1489 ds_put_char(ds, ',');
1493 json_string_to_ds(node->name, ds);
1494 ds_put_char(ds, ':');
1495 if (s->flags & JSSF_PRETTY) {
1496 ds_put_char(ds, ' ');
1498 json_to_ds(node->data, s);
1502 json_object_to_ds(const struct shash *object, struct json_serializer *s)
1504 struct ds *ds = &s->ds;
1506 ds_put_char(ds, '{');
1511 if (s->flags & JSSF_SORT) {
1512 const struct shash_node **nodes;
1515 nodes = shash_sort(object);
1516 n = shash_count(object);
1517 for (i = 0; i < n; i++) {
1518 json_object_member_to_ds(i, nodes[i], s);
1522 struct shash_node *node;
1526 SHASH_FOR_EACH (node, object) {
1527 json_object_member_to_ds(i++, node, s);
1531 ds_put_char(ds, '}');
1536 json_array_to_ds(const struct json_array *array, struct json_serializer *s)
1538 struct ds *ds = &s->ds;
1541 ds_put_char(ds, '[');
1547 for (i = 0; i < array->n; i++) {
1549 ds_put_char(ds, ',');
1552 json_to_ds(array->elems[i], s);
1557 ds_put_char(ds, ']');
1561 json_string_to_ds(const char *string, struct ds *ds)
1565 ds_put_char(ds, '"');
1566 while ((c = *string++) != '\0') {
1569 ds_put_cstr(ds, "\\\"");
1573 ds_put_cstr(ds, "\\\\");
1577 ds_put_cstr(ds, "\\b");
1581 ds_put_cstr(ds, "\\f");
1585 ds_put_cstr(ds, "\\n");
1589 ds_put_cstr(ds, "\\r");
1593 ds_put_cstr(ds, "\\t");
1600 ds_put_format(ds, "\\u%04x", c);
1605 ds_put_char(ds, '"');