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.
20 /* This is an implementation of JavaScript Object Notation (JSON) as specified
21 * by RFC 4627. It is intended to fully comply with RFC 4627, with the
22 * following known exceptions and clarifications:
24 * - Null bytes (\u0000) are not allowed in strings.
26 * - Only UTF-8 encoding is supported (RFC 4627 allows for other Unicode
29 * - Names within an object must be unique (RFC 4627 says that they
30 * "should" be unique).
35 /* Type of a JSON value. */
38 JSON_FALSE, /* false */
40 JSON_OBJECT, /* {"a": b, "c": d, ...} */
41 JSON_ARRAY, /* [1, 2, 3, ...] */
42 JSON_INTEGER, /* 123. */
43 JSON_REAL, /* 123.456. */
44 JSON_STRING, /* "..." */
48 const char *json_type_to_string(enum json_type);
52 size_t n, n_allocated;
60 struct shash *object; /* Contains "struct json *"s. */
61 struct json_array array;
62 long long int integer;
68 struct json *json_null_create(void);
69 struct json *json_boolean_create(bool);
70 struct json *json_string_create(const char *);
71 struct json *json_string_create_nocopy(char *);
72 struct json *json_integer_create(long long int);
73 struct json *json_real_create(double);
75 struct json *json_array_create_empty(void);
76 void json_array_add(struct json *, struct json *element);
77 void json_array_trim(struct json *);
78 struct json *json_array_create(struct json **, size_t n);
79 struct json *json_array_create_1(struct json *);
80 struct json *json_array_create_2(struct json *, struct json *);
81 struct json *json_array_create_3(struct json *, struct json *, struct json *);
83 struct json *json_object_create(void);
84 void json_object_put(struct json *, const char *name, struct json *value);
85 void json_object_put_string(struct json *,
86 const char *name, const char *value);
88 const char *json_string(const struct json *);
89 struct json_array *json_array(const struct json *);
90 struct shash *json_object(const struct json *);
91 bool json_boolean(const struct json *);
92 double json_real(const struct json *);
93 int64_t json_integer(const struct json *);
95 struct json *json_clone(const struct json *);
96 void json_destroy(struct json *);
98 size_t json_hash(const struct json *, size_t basis);
99 bool json_equal(const struct json *, const struct json *);
103 JSPF_TRAILER = 1 << 0 /* Check for garbage following input. */
106 struct json_parser *json_parser_create(int flags);
107 size_t json_parser_feed(struct json_parser *, const char *, size_t);
108 bool json_parser_is_done(const struct json_parser *);
109 struct json *json_parser_finish(struct json_parser *);
110 void json_parser_abort(struct json_parser *);
112 struct json *json_from_string(const char *string);
113 struct json *json_from_file(const char *file_name);
115 /* Serializing JSON. */
118 JSSF_PRETTY = 1 << 0, /* Multiple lines with indentation, if true. */
119 JSSF_SORT = 1 << 1 /* Object members in sorted order, if true. */
121 char *json_to_string(const struct json *, int flags);