jsmn.h revision 290001 
1#ifndef __JSMN_H_
2#define __JSMN_H_
3
4#include <stddef.h>
5
6#ifdef __cplusplus
7extern "C" {
8#endif
9
10/**
11 * JSON type identifier. Basic types are:
12 * 	o Object
13 * 	o Array
14 * 	o String
15 * 	o Other primitive: number, boolean (true/false) or null
16 */
17typedef enum {
18	JSMN_PRIMITIVE = 0,
19	JSMN_OBJECT = 1,
20	JSMN_ARRAY = 2,
21	JSMN_STRING = 3
22} jsmntype_t;
23
24typedef enum {
25	/* Not enough tokens were provided */
26	JSMN_ERROR_NOMEM = -1,
27	/* Invalid character inside JSON string */
28	JSMN_ERROR_INVAL = -2,
29	/* The string is not a full JSON packet, more bytes expected */
30	JSMN_ERROR_PART = -3
31} jsmnerr_t;
32
33/**
34 * JSON token description.
35 * @param		type	type (object, array, string etc.)
36 * @param		start	start position in JSON data string
37 * @param		end		end position in JSON data string
38 */
39typedef struct {
40	jsmntype_t type;
41	int start;
42	int end;
43	int size;
44#ifdef JSMN_PARENT_LINKS
45	int parent;
46#endif
47} jsmntok_t;
48
49/**
50 * JSON parser. Contains an array of token blocks available. Also stores
51 * the string being parsed now and current position in that string
52 */
53typedef struct {
54	unsigned int pos; /* offset in the JSON string */
55	unsigned int toknext; /* next token to allocate */
56	int toksuper; /* superior token node, e.g parent object or array */
57} jsmn_parser;
58
59/**
60 * Create JSON parser over an array of tokens
61 */
62void jsmn_init(jsmn_parser *parser);
63
64/**
65 * Run JSON parser. It parses a JSON data string into and array of tokens, each describing
66 * a single JSON object.
67 */
68jsmnerr_t jsmn_parse(jsmn_parser *parser, const char *js, size_t len,
69		jsmntok_t *tokens, unsigned int num_tokens);
70
71#ifdef __cplusplus
72}
73#endif
74
75#endif /* __JSMN_H_ */
76