41bb9ce3ad363ddc074e50a6f11396101371cf92
[profile/ivi/jansson.git] / src / jansson.h
1 #ifndef JANSSON_H
2 #define JANSSON_H
3
4 #include <stdio.h>
5 #include <stdint.h>
6
7 /* types */
8
9 typedef enum {
10     JSON_OBJECT,
11     JSON_ARRAY,
12     JSON_STRING,
13     JSON_NUMBER,
14     JSON_TRUE,
15     JSON_FALSE,
16     JSON_NULL
17 } json_type;
18
19 typedef struct {
20     json_type type;
21     unsigned long refcount;
22 } json_t;
23
24 #define json_typeof(json)      ((json)->type)
25 #define json_is_object(json)   (json && json_typeof(json) == JSON_OBJECT)
26 #define json_is_array(json)    (json && json_typeof(json) == JSON_ARRAY)
27 #define json_is_string(json)   (json && json_typeof(json) == JSON_STRING)
28 #define json_is_number(json)   (json && json_typeof(json) == JSON_NUMBER)
29 #define json_is_true(json)     (json && json_typeof(json) == JSON_TRUE)
30 #define json_is_false(json)    (json && json_typeof(json) == JSON_FALSE)
31 #define json_is_null(json)     (json && json_typeof(json) == JSON_NULL)
32
33 /* construction, destruction, reference counting */
34
35 json_t *json_object(void);
36 json_t *json_array(void);
37 json_t *json_string(const char *value);
38 json_t *json_number(double value);
39 json_t *json_true(void);
40 json_t *json_false(void);
41 json_t *json_null(void);
42
43 json_t *json_clone(json_t *json);
44
45 static inline json_t *json_incref(json_t *json)
46 {
47     if(json)
48         ++json->refcount;
49     return json;
50 }
51
52 /* do not call json_delete directly */
53 void json_delete(json_t *json);
54
55 static inline void json_decref(json_t *json)
56 {
57     if(json && --json->refcount == 0)
58         json_delete(json);
59 }
60
61
62 /* getters, setters, manipulation */
63
64 json_t *json_object_get(const json_t *object, const char *key);
65 int json_object_set(json_t *object, const char *key, json_t *value);
66 int json_object_del(json_t *object, const char *key);
67 void *json_object_iter(json_t *object);
68 void *json_object_iter_next(json_t *object, void *iter);
69 const char *json_object_iter_key(void *iter);
70 json_t *json_object_iter_value(void *iter);
71
72 unsigned int json_array_size(const json_t *array);
73 json_t *json_array_get(const json_t *array, unsigned int index);
74 int json_array_set(json_t *array, unsigned int index, json_t *value);
75 int json_array_append(json_t *array, json_t *value);
76
77 const char *json_string_value(const json_t *json);
78 double json_number_value(const json_t *json);
79
80
81 /* loading, printing */
82
83 const char *json_get_error(void);
84
85 json_t *json_load(const char *path);
86 json_t *json_loads(const char *input);
87 json_t *json_loadf(FILE *input);
88
89 #define JSON_INDENT(n)   (n & 0xFF)
90 #define JSON_SORT_KEYS   0x100
91
92 int json_dump(const json_t *json, const char *path, uint32_t flags);
93 char *json_dumps(const json_t *json, uint32_t flags);
94 int json_dumpf(const json_t *json, FILE *output, uint32_t flags);
95
96 #endif