-// janssonxx - C++ wrapper for jansson
+// Copyright (c) 2010 Sean Middleditch <sean@middleditch.us>
+// Copyright (c) 2010 Petri Lehtinen <petri@digip.org>
//
-// author: Sean Middleditch <sean@middleditch.us>
-//
-// janssonxx is free software; you can redistribute it and/or modify
+// Jansson is free software; you can redistribute it and/or modify
// it under the terms of the MIT license. See LICENSE for details.
-#if !defined(JANSSON_HPP)
-#define JANSSON_HPP 1
+#ifndef JANSSON_HPP
+#define JANSSON_HPP
#include <string>
#include <ostream>
#include <istream>
#include <sstream>
-#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;
- // 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);
+// Included so that standard functions don't end up in namespace json
+#include <cstdio>
- // 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;
+// For free()
+#include <cstdlib>
- // get value at array index (const version)
- inline const Value at(unsigned int index) const;
+namespace json {
+ // include Jansson C library into the json namespace
+# include <jansson.h>
+
+ class Iterator;
+ class Value;
+
+ // implementation details; do not use directly
+ namespace detail {
+ class ElementProxy;
+ class PropertyProxy;
- 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;
+ // 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);
- // get value at array index (non-const version)
- inline ValueBase<ElementProxy> at(unsigned int index);
+ // 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;
- 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 size of array or object
+ inline unsigned int size() const;
- // get object property (const version)
- inline const Value get(const char* key) const;
+ // get value at array index (const version)
+ inline const Value at(unsigned int index) 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 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);
+
+ 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 (non-const version)
- inline ValueBase<PropertyProxy> get(const char* key);
+ // get object property (const version)
+ inline const Value get(const char* key) const;
- inline ValueBase<PropertyProxy> get(const std::string& key);
- inline ValueBase<PropertyProxy> operator[](const char* key);
- inline ValueBase<PropertyProxy> operator[](const std::string& key);
+ 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);
+
+ 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();
+
+ // 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);
- // clear all array/object values
- inline void clear();
+ inline _Base& set_key(const std::string& key, const Value& value);
- // 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 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 dump_file(const char* path, int flags = 0) const;
+ inline int dump_file(const std::string& path, int flags = 0) const;
+
+ // write the value to a string (caller must deallocate with free()!)
+ inline char* dumps(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;
- // set an object property (converts value to object is not one already)
- inline _Base& set_key(const char* key, const Value& value);
+ // take ownership of a json_t (does not increase reference count)
+ inline static Basic take_ownership(json_t* json);
- 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;
+ 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:
+ ElementProxy(json_t* array, unsigned int index);
+ ElementProxy(const ElementProxy& other);
+ ~ElementProxy();
- 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:
+ PropertyProxy(json_t* object, const char *key);
+ PropertyProxy(const PropertyProxy& other);
+ ~PropertyProxy();
- // 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;
+ // iterator pointing to property
+ void* _iter;
- private:
- // array object we wrap
- json_t* _object;
+ // key of property
+ char* _key;
+ };
- // key of property
- const char* _key;
- };
+ } // namespace json::detail
- } // namespace json::_private
+ // represents any JSON value
+ class Value : public detail::ValueBase<detail::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);
- // 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);
+ // empty constructor
+ Value() : detail::ValueBase<detail::Basic>() {}
- // empty constructor
- Value() : _private::ValueBase<_private::Basic>() {}
+ // copy constructor for base
+ Value(const detail::Basic& value) : detail::ValueBase<detail::Basic>(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) {}
+ // copy constructor for base
+ Value(const detail::ValueBase<detail::Basic>& value) : detail::ValueBase<detail::Basic>(value) {}
- // copy constructor
- Value(const Value& value) : _private::ValueBase<_private::Basic>(value) {}
+ // copy constructor
+ Value(const Value& value) : detail::ValueBase<detail::Basic>(value) {}
- // create reference to value
- explicit Value(json_t* json) : _private::ValueBase<_private::Basic>(json) {}
- };
+ // create reference to value
+ explicit Value(json_t* json) : detail::ValueBase<detail::Basic>(json) {}
+ };
- // iterators over a JSON object
- class Iterator {
- public:
- // construct a new iterator for a given object
- inline Iterator(const Value& value);
+ // iterators over a JSON object
+ class Iterator {
+ public:
+ // construct a new iterator for a given object
+ inline Iterator(const Value& value);
- // construct a new iterator for a given object
- inline Iterator(const _private::ValueBase<_private::PropertyProxy>& value);
+ // construct a new iterator for a given object
+ inline Iterator(const detail::ValueBase<detail::PropertyProxy>& value);
- // increment iterator
- inline void next();
+ // increment iterator
+ inline void next();
- inline Iterator& operator++();
+ inline Iterator& operator++();
- // test if iterator is still valid
- inline bool valid() const;
+ // test if iterator is still valid
+ inline bool valid() const;
- inline operator bool() const;
+ inline operator bool() const;
- // get key
- inline const char* ckey() const;
+ // get key
+ inline const char* ckey() const;
- inline std::string key() const;
+ inline std::string key() const;
- // get value
- inline const Value value() const;
+ // get value
+ inline const Value value() const;
- // dereference value
- inline const Value operator*() const;
+ // dereference value
+ inline const Value operator*() const;
- private:
- // disallow copying
- Iterator(const Iterator&);
- Iterator& operator=(const Iterator&);
+ private:
+ // disallow copying
+ Iterator(const Iterator&);
+ Iterator& operator=(const Iterator&);
- // object being iterated over
- Value _object;
+ // object being iterated over
+ Value _object;
- // iterator value
- void* _iter;
- };
+ // iterator value
+ void* _iter;
+ };
- // create a new empty object
- inline Value object();
+ // create a new empty object
+ inline Value object();
- // create a new empty array
- inline Value array();
+ // create a new empty array
+ inline Value array();
- // create a new null value
- inline Value null();
+ // create a new null value
+ inline Value null();
- // load a file as a JSON value
- inline Value load_file(const char* path, json_error_t* error = 0);
+ // load a file as a JSON value
+ inline Value load_file(const char* path, json_error_t* error = 0);
+ inline Value load_file(const std::string& 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);
+ // load a string as a JSON value
+ inline Value loads(const char* string, json_error_t* error = 0);
+ inline Value loads(const std::string& string, json_error_t* error = 0);
-} // namespace json
+} // namespace json
// stream JSON value out -- inefficient and not recommended for production use
inline std::ostream& operator<<(std::ostream& os, const json::Value& value);
inline std::istream& operator>>(std::istream& is, json::Value& value);
// include implementation code
-#define IN_JANSSON_HPP 1
-#include "jansson-impl.hpp"
+#define IN_JANSSON_HPP
+#include "jansson.ipp"
#undef IN_JANSSON_HPP
#endif // defined(JANSSON_HPP)
projects / jansson.git / blobdiff