/usr/include/dovecot/json-parser.h is in dovecot-dev 1:2.2.22-1ubuntu2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 | #ifndef JSON_PARSER_H
#define JSON_PARSER_H
enum json_type {
/* { key: */
JSON_TYPE_OBJECT_KEY,
/* : { new object */
JSON_TYPE_OBJECT,
/* } (not returned for the root object) */
JSON_TYPE_OBJECT_END,
JSON_TYPE_ARRAY,
JSON_TYPE_ARRAY_END,
JSON_TYPE_STRING,
JSON_TYPE_NUMBER,
JSON_TYPE_TRUE,
JSON_TYPE_FALSE,
JSON_TYPE_NULL
};
enum json_parser_flags {
/* By default we assume that the input is an object and parsing skips
the root level "{" and "}". If this flag is set, it's possible to
parse any other type of JSON values directly. */
JSON_PARSER_NO_ROOT_OBJECT = 0x01
};
/* Parse JSON tokens from the input stream. */
struct json_parser *json_parser_init(struct istream *input);
struct json_parser *json_parser_init_flags(struct istream *input,
enum json_parser_flags flags);
int json_parser_deinit(struct json_parser **parser, const char **error_r);
/* Parse the next token. Returns 1 if found, 0 if more input stream is
non-blocking and needs more input, -1 if input stream is at EOF. */
int json_parse_next(struct json_parser *parser, enum json_type *type_r,
const char **value_r);
/* Skip the next object value. If it's an object, its members are also
skipped. */
void json_parse_skip_next(struct json_parser *parser);
/* Return the following string as input stream. Returns 1 if ok, 0 if
input stream is non-blocking and needs more input, -1 if the next token
isn't a string (call json_parse_next()). */
int json_parse_next_stream(struct json_parser *parser,
struct istream **input_r);
/* Append data to already opened JSON string. src should be valid UTF-8 data. */
void json_append_escaped(string_t *dest, const char *src);
/* Same as json_append_escaped(), but append non-\0 terminated input. */
void json_append_escaped_data(string_t *dest, const unsigned char *src, size_t size);
void ostream_escaped_json_format(string_t *dest, unsigned char src);
#endif
|