1 #if !defined(JANSSONXX_H)
8 // include in the jansson namespace
13 // represents any JSON value
16 // construct new Value with an undefined value
17 Value() : _value(0) {}
19 // free Value resources
20 ~Value() { json_decref(_value); }
22 // copy an existing Value
23 Value(const Value& e) : _value(json_incref(e._value)) {}
25 // make a reference to an existing json_t value
26 explicit Value(json_t* value) : _value(json_incref(value)) {}
28 // copy an existing Value
29 Value& operator=(const Value& e) {
31 _value = json_incref(e._value);
35 // take ownership of a json_t (does not increase reference count)
36 Value& take_ownership(json_t* value) {
42 // load a file as a JSON value
43 static Value load_file(const char* path, json_error_t* error = 0) {
44 return Value().take_ownership(json_load_file(path, error));
47 // load a string as a JSON value
48 static Value load_string(const char* string, json_error_t* error = 0) {
49 return Value().take_ownership(json_loads(string, error));
52 // construct Value from input
53 static Value from(const char* value) { return Value().take_ownership(json_string(value)); }
54 static Value from(const std::string& value) { return from(value.c_str()); }
55 static Value from(bool value) { return Value().take_ownership(value ? json_true() : json_false()); }
56 static Value from(int value) { return Value().take_ownership(json_integer(value)); }
57 static Value from(double value) { return Value().take_ownership(json_real(value)); }
59 // create a new empty object
60 static Value object() { return Value().take_ownership(json_object()); }
62 // create a new empty array
63 static Value array() { return Value().take_ownership(json_array()); }
65 // create a new null value
66 static Value null() { return Value().take_ownership(json_null()); }
68 // get the underlying json_t
69 json_t* as_json_t() const { return _value; }
72 bool is_undefined() const { return _value == 0; }
73 bool is_object() const { return json_is_object(_value); }
74 bool is_array() const { return json_is_array(_value); }
75 bool is_string() const { return json_is_string(_value); }
76 bool is_integer() const { return json_is_integer(_value); }
77 bool is_real() const { return json_is_real(_value); }
78 bool is_number() const { return json_is_number(_value); }
79 bool is_true() const { return json_is_true(_value); }
80 bool is_false() const { return json_is_false(_value); }
81 bool is_boolean() const { return json_is_boolean(_value); }
82 bool is_null() const { return json_is_null(_value); }
84 // get size of array or object
85 unsigned int size() const {
87 return json_object_size(_value);
89 return json_array_size(_value);
94 // get value at array index (const version)
95 const Value at(unsigned int index) const {
97 return Value(json_array_get(_value, index));
102 const Value operator[](signed int index) const { return at(index); }
103 const Value operator[](unsigned int index) const { return at(index); }
104 const Value operator[](signed short index) const { return at(index); }
105 const Value operator[](unsigned short index) const { return at(index); }
106 const Value operator[](signed long index) const { return at(index); }
107 const Value operator[](unsigned long index) const { return at(index); }
109 // get value at array index (non-const version)
110 Value at(unsigned int index) {
112 return Value(json_array_get(_value, index));
117 Value operator[](signed int index) { return at(index); }
118 Value operator[](unsigned int index) { return at(index); }
119 Value operator[](signed short index) { return at(index); }
120 Value operator[](unsigned short index) { return at(index); }
121 Value operator[](signed long index) { return at(index); }
122 Value operator[](unsigned long index) { return at(index); }
124 // get object property
125 const Value get(const char* key) const {
127 return Value(json_object_get(_value, key));
132 const Value get(const std::string& key) const { return get(key.c_str()); }
133 const Value operator[](const char* key) const { return get(key); }
134 const Value operator[](const std::string& key) const { return get(key.c_str()); }
136 // clear all array/object values
139 json_object_clear(_value);
141 json_array_clear(_value);
144 // get value cast to specified type
145 const char* as_cstring() const { return json_string_value(_value); }
146 std::string as_string() const { return as_cstring(); }
147 int as_integer() const { return json_integer_value(_value); }
148 double as_real() const { return json_real_value(_value); }
149 double as_number() const { return json_number_value(_value); }
150 bool as_boolean() const { return is_true(); }
152 // set an object property (converts value to object is not one already)
153 Value& set(const char* key, const Value& value) {
156 _value = json_object();
159 json_object_set(_value, key, value.as_json_t());
164 // set an array index (converts value to object is not one already)
165 Value& set(unsigned int index, const Value& value) {
168 _value = json_array();
172 json_array_append(_value, value.as_json_t());
174 json_array_set(_value, index, value.as_json_t());
179 Value& set(int index, const Value& value) { return set(static_cast<unsigned int>(index), value); }
182 // internal value pointer
186 // iterators over a JSON object
189 // construct a new iterator for a given object
190 Iterator(const Value& value) : _object(value), _iter(0) {
191 _iter = json_object_iter(_object.as_json_t());
194 // increment iterator
197 _iter = json_object_iter_next(_object.as_json_t(), _iter);
200 Iterator& operator++() { next(); return *this; }
202 // test if iterator is still valid
203 bool valid() const { return _iter != 0; }
204 operator bool() const { return valid(); }
207 const char* ckey() const {
209 return json_object_iter_key(_iter);
214 std::string key() const { return ckey(); }
217 const Value value() const {
219 return Value(json_object_iter_value(_iter));
225 const Value operator*() const { return value(); }
229 Iterator(const Iterator&);
230 Iterator& operator=(const Iterator&);
232 // object being iterated over
239 } // namespace jansson