diff options
Diffstat (limited to 'src/jansson.hpp')
| -rw-r--r-- | src/jansson.hpp | 446 |
1 files changed, 223 insertions, 223 deletions
diff --git a/src/jansson.hpp b/src/jansson.hpp index 1bd18b1..020a277 100644 --- a/src/jansson.hpp +++ b/src/jansson.hpp @@ -13,281 +13,281 @@ #include <cstdlib> namespace json { - // include Jansson C library into the json namespace - #include <jansson.h> - - class Iterator; - class Value; - - // implementation details; do not use directly - namespace _private { - class ElementProxy; - class PropertyProxy; + // include Jansson C library into the json namespace +# include <jansson.h> + + class Iterator; + class Value; + + // implementation details; do not use directly + namespace _private { + class ElementProxy; + class PropertyProxy; - // base class for JSON value interface - template <typename _Base> - class ValueBase : public _Base { - public: - // empty constructor - ValueBase() : _Base() {} - - // copy constructor - ValueBase(const _Base& base) : _Base(base) {} - - // create reference to value - ValueBase(json_t* json) : _Base(json) {} - - // assignment operator - inline ValueBase& operator=(const Value& value); + // base class for JSON value interface + template <typename _Base> + class ValueBase : public _Base { + public: + // empty constructor + ValueBase() : _Base() {} + + // copy constructor + ValueBase(const _Base& base) : _Base(base) {} + + // create reference to value + ValueBase(json_t* json) : _Base(json) {} + + // assignment operator + inline ValueBase& operator=(const Value& value); - // check value type - inline bool is_undefined() const; - inline bool is_object() const; - inline bool is_array() const; - inline bool is_string() const; - inline bool is_integer() const; - inline bool is_real() const; - inline bool is_number() const; - inline bool is_true() const; - inline bool is_false() const; - inline bool is_boolean() const; - inline bool is_null() const; + // check value type + inline bool is_undefined() const; + inline bool is_object() const; + inline bool is_array() const; + inline bool is_string() const; + inline bool is_integer() const; + inline bool is_real() const; + inline bool is_number() const; + inline bool is_true() const; + inline bool is_false() const; + inline bool is_boolean() const; + inline bool is_null() const; - // get size of array or object - inline unsigned int size() const; + // get size of array or object + inline unsigned int size() const; - // get value at array index (const version) - inline const Value at(unsigned int index) const; + // get value at array index (const version) + inline const Value at(unsigned int index) const; - inline const Value operator[](signed int index) const; - inline const Value operator[](unsigned int index) const; - inline const Value operator[](signed short index) const; - inline const Value operator[](unsigned short index) const; - inline const Value operator[](signed long index) const; - inline const Value operator[](unsigned long index) const; + inline const Value operator[](signed int index) const; + inline const Value operator[](unsigned int index) const; + inline const Value operator[](signed short index) const; + inline const Value operator[](unsigned short index) const; + inline const Value operator[](signed long index) const; + inline const Value operator[](unsigned long index) const; - // get value at array index (non-const version) - inline ValueBase<ElementProxy> at(unsigned int index); + // get value at array index (non-const version) + inline ValueBase<ElementProxy> at(unsigned int index); - inline ValueBase<ElementProxy> operator[](signed int index); - inline ValueBase<ElementProxy> operator[](unsigned int index); - inline ValueBase<ElementProxy> operator[](signed short index); - inline ValueBase<ElementProxy> operator[](unsigned short index); - inline ValueBase<ElementProxy> operator[](signed long index); - inline ValueBase<ElementProxy> operator[](unsigned long index); + inline ValueBase<ElementProxy> operator[](signed int index); + inline ValueBase<ElementProxy> operator[](unsigned int index); + inline ValueBase<ElementProxy> operator[](signed short index); + inline ValueBase<ElementProxy> operator[](unsigned short index); + inline ValueBase<ElementProxy> operator[](signed long index); + inline ValueBase<ElementProxy> operator[](unsigned long index); - // get object property (const version) - inline const Value get(const char* key) const; + // get object property (const version) + inline const Value get(const char* key) const; - inline const Value get(const std::string& key) const; - inline const Value operator[](const char* key) const; - inline const Value operator[](const std::string& key) const; + inline const Value get(const std::string& key) const; + inline const Value operator[](const char* key) const; + inline const Value operator[](const std::string& key) const; - // get object property (non-const version) - inline ValueBase<PropertyProxy> get(const char* key); + // get object property (non-const version) + inline ValueBase<PropertyProxy> get(const char* key); - inline ValueBase<PropertyProxy> get(const std::string& key); - inline ValueBase<PropertyProxy> operator[](const char* key); - inline ValueBase<PropertyProxy> operator[](const std::string& key); + inline ValueBase<PropertyProxy> get(const std::string& key); + inline ValueBase<PropertyProxy> operator[](const char* key); + inline ValueBase<PropertyProxy> operator[](const std::string& key); - // clear all array/object values - inline void clear(); + // clear all array/object values + inline void clear(); - // get value cast to specified type - inline const char* as_cstring() const; - inline std::string as_string() const; - inline int as_integer() const; - inline double as_real() const; - inline double as_number() const; - inline bool as_boolean() const; + // get value cast to specified type + inline const char* as_cstring() const; + inline std::string as_string() const; + inline int as_integer() const; + inline double as_real() const; + inline double as_number() const; + inline bool as_boolean() const; - // set an object property (converts value to object is not one already) - inline _Base& set_key(const char* key, const Value& value); + // set an object property (converts value to object is not one already) + inline _Base& set_key(const char* key, const Value& value); - inline _Base& set_key(const std::string& key, const Value& value); - - // set an array index (converts value to object is not one already) - inline _Base& set_at(unsigned int index, const Value& value); - - // delete an object key - inline _Base& del_key(const char* key); - - inline _Base& del_key(const std::string& key); - - // delete an item from an array by index - inline _Base& del_at(unsigned int index); - - // insert an item into an array at a given index - inline _Base& insert_at(unsigned int index, const Value& value); - - // write the value to a file - inline int save_file(const char* path, int flags = 0) const; - - // write the value to a string (caller must deallocate with free()!) - inline char* save_string(int flags = 0) const; - }; - - // represents any JSON value, private base - class Basic { - public: - // construct new Value with an undefined value - Basic() : _value(0) {} - - // copy constructor - Basic(const Basic& value) : _value(json_incref(value._value)) {} - - // make a reference to an existing json_t value - explicit Basic(json_t* value) : _value(json_incref(value)) {} - - // free Value resources - inline ~Basic(); - - // copy an existing Value - inline Basic& operator=(const Basic& e); - - // get the underlying json_t - inline json_t* as_json() const; + inline _Base& set_key(const std::string& key, const Value& value); + + // set an array index (converts value to object is not one already) + inline _Base& set_at(unsigned int index, const Value& value); + + // delete an object key + inline _Base& del_key(const char* key); + + inline _Base& del_key(const std::string& key); + + // delete an item from an array by index + inline _Base& del_at(unsigned int index); + + // insert an item into an array at a given index + inline _Base& insert_at(unsigned int index, const Value& value); + + // write the value to a file + inline int save_file(const char* path, int flags = 0) const; + + // write the value to a string (caller must deallocate with free()!) + inline char* save_string(int flags = 0) const; + }; + + // represents any JSON value, private base + class Basic { + public: + // construct new Value with an undefined value + Basic() : _value(0) {} + + // copy constructor + Basic(const Basic& value) : _value(json_incref(value._value)) {} + + // make a reference to an existing json_t value + explicit Basic(json_t* value) : _value(json_incref(value)) {} + + // free Value resources + inline ~Basic(); + + // copy an existing Value + inline Basic& operator=(const Basic& e); - // take ownership of a json_t (does not increase reference count) - inline static Basic take_ownership(json_t* json); + // get the underlying json_t + inline json_t* as_json() const; - protected: - // internal value pointer - json_t* _value; - }; + // take ownership of a json_t (does not increase reference count) + inline static Basic take_ownership(json_t* json); - // proxies an array element - class ElementProxy { - public: - // constructor - ElementProxy(json_t* array, unsigned int index) : _array(array), _index(index) {} + protected: + // internal value pointer + json_t* _value; + }; - // assign to the proxied element - inline ElementProxy& operator=(const Value& value); + // proxies an array element + class ElementProxy { + public: + // constructor + ElementProxy(json_t* array, unsigned int index) : _array(array), _index(index) {} - // get the proxied element - inline json_t* as_json() const; + // assign to the proxied element + inline ElementProxy& operator=(const Value& value); - private: - // array object we wrap - json_t* _array; + // get the proxied element + inline json_t* as_json() const; - // index of property - unsigned int _index; - }; + private: + // array object we wrap + json_t* _array; - // proxies an object property - class PropertyProxy { - public: - // constructor - PropertyProxy(json_t* array, const char* key) : _object(array), _key(key) {} + // index of property + unsigned int _index; + }; - // assign to the proxied element - inline PropertyProxy& operator=(const Value& value); + // proxies an object property + class PropertyProxy { + public: + // constructor + PropertyProxy(json_t* array, const char* key) : _object(array), _key(key) {} - // get the proxied element - inline json_t* as_json() const; + // assign to the proxied element + inline PropertyProxy& operator=(const Value& value); - private: - // array object we wrap - json_t* _object; + // get the proxied element + inline json_t* as_json() const; - // key of property - const char* _key; - }; + private: + // array object we wrap + json_t* _object; - } // namespace json::_private + // key of property + const char* _key; + }; - // represents any JSON value - class Value : public _private::ValueBase<_private::Basic> { - public: - // construct Value from input - explicit inline Value(const char* value); - explicit inline Value(const std::string& value); - explicit inline Value(bool value); - explicit inline Value(signed int value); - explicit inline Value(unsigned int value); - explicit inline Value(signed short value); - explicit inline Value(unsigned short value); - explicit inline Value(signed long value); - explicit inline Value(unsigned long value); - explicit inline Value(float value); - explicit inline Value(double value); + } // namespace json::_private - // empty constructor - Value() : _private::ValueBase<_private::Basic>() {} + // represents any JSON value + class Value : public _private::ValueBase<_private::Basic> { + public: + // construct Value from input + explicit inline Value(const char* value); + explicit inline Value(const std::string& value); + explicit inline Value(bool value); + explicit inline Value(signed int value); + explicit inline Value(unsigned int value); + explicit inline Value(signed short value); + explicit inline Value(unsigned short value); + explicit inline Value(signed long value); + explicit inline Value(unsigned long value); + explicit inline Value(float value); + explicit inline Value(double value); - // copy constructor for base - Value(const _private::Basic& value) : _private::ValueBase<_private::Basic>(value) {} - - // copy constructor for base - Value(const _private::ValueBase<_private::Basic>& value) : _private::ValueBase<_private::Basic>(value) {} + // empty constructor + Value() : _private::ValueBase<_private::Basic>() {} - // copy constructor - Value(const Value& value) : _private::ValueBase<_private::Basic>(value) {} + // copy constructor for base + Value(const _private::Basic& value) : _private::ValueBase<_private::Basic>(value) {} - // create reference to value - explicit Value(json_t* json) : _private::ValueBase<_private::Basic>(json) {} - }; + // copy constructor for base + Value(const _private::ValueBase<_private::Basic>& value) : _private::ValueBase<_private::Basic>(value) {} - // iterators over a JSON object - class Iterator { - public: - // construct a new iterator for a given object - inline Iterator(const Value& value); + // copy constructor + Value(const Value& value) : _private::ValueBase<_private::Basic>(value) {} - // construct a new iterator for a given object - inline Iterator(const _private::ValueBase<_private::PropertyProxy>& value); + // create reference to value + explicit Value(json_t* json) : _private::ValueBase<_private::Basic>(json) {} + }; - // increment iterator - inline void next(); + // iterators over a JSON object + class Iterator { + public: + // construct a new iterator for a given object + inline Iterator(const Value& value); - inline Iterator& operator++(); + // construct a new iterator for a given object + inline Iterator(const _private::ValueBase<_private::PropertyProxy>& value); - // test if iterator is still valid - inline bool valid() const; + // increment iterator + inline void next(); - inline operator bool() const; + inline Iterator& operator++(); - // get key - inline const char* ckey() const; + // test if iterator is still valid + inline bool valid() const; - inline std::string key() const; + inline operator bool() const; - // get value - inline const Value value() const; + // get key + inline const char* ckey() const; - // dereference value - inline const Value operator*() const; + inline std::string key() const; - private: - // disallow copying - Iterator(const Iterator&); - Iterator& operator=(const Iterator&); + // get value + inline const Value value() const; - // object being iterated over - Value _object; + // dereference value + inline const Value operator*() const; - // iterator value - void* _iter; - }; + private: + // disallow copying + Iterator(const Iterator&); + Iterator& operator=(const Iterator&); - // create a new empty object - inline Value object(); + // object being iterated over + Value _object; - // create a new empty array - inline Value array(); + // iterator value + void* _iter; + }; - // create a new null value - inline Value null(); + // create a new empty object + inline Value object(); - // load a file as a JSON value - inline Value load_file(const char* path, json_error_t* error = 0); + // create a new empty array + inline Value array(); - // load a string as a JSON value - inline Value load_string(const char* string, json_error_t* error = 0); + // create a new null value + inline Value null(); -} // namespace json + // load a file as a JSON value + inline Value load_file(const char* path, json_error_t* error = 0); + + // load a string as a JSON value + inline Value load_string(const char* string, json_error_t* error = 0); + +} // namespace json // stream JSON value out -- inefficient and not recommended for production use inline std::ostream& operator<<(std::ostream& os, const json::Value& value); |