summaryrefslogtreecommitdiffstats
path: root/contrib/ccan/json/json.h
blob: 6eef48a6f6ac9d6598f776c2521dd52a1c9f3004 (plain)
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
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
/* SPDX-License-Identifier: MIT
 * Source: https://ccodearchive.net/info/json.html
 * Copyright (C) 2011 Joseph A. Adams (joeyadams3.14159@gmail.com) */

#ifndef CCAN_JSON_H
#define CCAN_JSON_H

#include <lib/defines.h>
#include <stdbool.h>
#include <stddef.h>

typedef enum {
	JSON_NULL,
	JSON_BOOL,
	JSON_STRING,
	JSON_NUMBER,
	JSON_ARRAY,
	JSON_OBJECT,
} JsonTag;

typedef struct JsonNode JsonNode;

struct JsonNode
{
	/* only if parent is an object or array (NULL otherwise) */
	JsonNode *parent;
	JsonNode *prev, *next;
	
	/* only if parent is an object (NULL otherwise) */
	char *key; /* Must be valid UTF-8. */
	
	JsonTag tag;
	union {
		/* JSON_BOOL */
		bool bool_;
		
		/* JSON_STRING */
		char *string_; /* Must be valid UTF-8. */
		
		/* JSON_NUMBER */
		double number_;
		
		/* JSON_ARRAY */
		/* JSON_OBJECT */
		struct {
			JsonNode *head, *tail;
		} children;
	};
};

/*** Encoding, decoding, and validation ***/

KR_EXPORT JsonNode   *json_decode         (const char *json);
KR_EXPORT char       *json_encode         (const JsonNode *node);
KR_EXPORT char       *json_encode_string  (const char *str);
KR_EXPORT char       *json_stringify      (const JsonNode *node, const char *space);
KR_EXPORT void        json_delete         (JsonNode *node);

KR_EXPORT bool        json_validate       (const char *json);

/*** Lookup and traversal ***/

KR_EXPORT JsonNode   *json_find_element   (JsonNode *array, int index);
KR_EXPORT JsonNode   *json_find_member    (JsonNode *object, const char *key);

KR_EXPORT JsonNode   *json_first_child    (const JsonNode *node);

#define json_foreach(i, object_or_array)            \
	for ((i) = json_first_child(object_or_array);   \
		 (i) != NULL;                               \
		 (i) = (i)->next)

/*** Construction and manipulation ***/

KR_EXPORT JsonNode *json_mknull(void);
KR_EXPORT JsonNode *json_mkbool(bool b);
KR_EXPORT JsonNode *json_mkstring(const char *s);
KR_EXPORT JsonNode *json_mknumber(double n);
KR_EXPORT JsonNode *json_mkarray(void);
KR_EXPORT JsonNode *json_mkobject(void);

KR_EXPORT void json_append_element(JsonNode *array, JsonNode *element);
KR_EXPORT void json_prepend_element(JsonNode *array, JsonNode *element);
KR_EXPORT void json_append_member(JsonNode *object, const char *key, JsonNode *value);
KR_EXPORT void json_prepend_member(JsonNode *object, const char *key, JsonNode *value);

KR_EXPORT void json_remove_from_parent(JsonNode *node);

/*** Debugging ***/

/*
 * Look for structure and encoding problems in a JsonNode or its descendents.
 *
 * If a problem is detected, return false, writing a description of the problem
 * to errmsg (unless errmsg is NULL).
 */
KR_EXPORT bool json_check(const JsonNode *node, char errmsg[256]);

#endif