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