summaryrefslogtreecommitdiff
path: root/plugins/JSON/libJSON.h
diff options
context:
space:
mode:
authorVadim Dashevskiy <watcherhd@gmail.com>2012-05-23 07:44:30 +0000
committerVadim Dashevskiy <watcherhd@gmail.com>2012-05-23 07:44:30 +0000
commitf3d44bc057201407373012b7f682881bda7b3d98 (patch)
treeddf031a82529c84e13222131cf184ecf176d3954 /plugins/JSON/libJSON.h
parentc2d827972a16f1710406d15e58304aecc4e1c9b5 (diff)
some includes restored, mir_full.sln updated, some renaming of folders and projects
git-svn-id: http://svn.miranda-ng.org/main/trunk@140 1316c22d-e87f-b044-9b9b-93d7a3e3ba9c
Diffstat (limited to 'plugins/JSON/libJSON.h')
-rw-r--r--plugins/JSON/libJSON.h210
1 files changed, 210 insertions, 0 deletions
diff --git a/plugins/JSON/libJSON.h b/plugins/JSON/libJSON.h
new file mode 100644
index 0000000000..83d37c46d7
--- /dev/null
+++ b/plugins/JSON/libJSON.h
@@ -0,0 +1,210 @@
+#ifndef LIBJSON_H
+#define LIBJSON_H
+
+#include "Source/JSONDefs.h" //for typedefs of functions, strings, and nodes
+
+#ifdef LIBJSON_EXPORTS
+#define LIBJSON_DLL _declspec(dllexport)
+#else
+#define LIBJSON_DLL _declspec(dllimport)
+#endif
+
+/*
+ This is the C interface to libJSON.
+
+ This file also declares various things that are needed for
+ C++ programming
+*/
+
+#ifdef JSON_LIBRARY //compiling the library, hide the interface
+ #ifdef __cplusplus
+ #ifdef JSON_UNIT_TEST
+ #include "Source/JSONNode.h"
+ #endif
+ extern "C" {
+ #endif
+
+ /*
+ stuff that's in namespace libJSON
+ */
+ LIBJSON_DLL void json_free(void * str);
+ LIBJSON_DLL void json_delete(JSONNODE * node);
+ #ifdef JSON_MEMORY_MANAGE
+ LIBJSON_DLL void json_free_all(void);
+ LIBJSON_DLL void json_delete_all(void);
+ #endif
+ LIBJSON_DLL JSONNODE * json_parse(const json_char * json);
+ LIBJSON_DLL json_char * json_strip_white_space(const json_char * json);
+ #ifdef JSON_VALIDATE
+ LIBJSON_DLL JSONNODE * json_validate(const json_char * json);
+ #endif
+ #if defined JSON_DEBUG && !defined JSON_STDERROR
+ //When libjson errors, a callback allows the user to know what went wrong
+ LIBJSON_DLL void json_register_debug_callback(json_error_callback_t callback);
+ #endif
+ #ifdef JSON_MUTEX_CALLBACKS
+ #ifdef JSON_MUTEX_MANAGE
+ LIBJSON_DLL void json_register_mutex_callbacks(json_mutex_callback_t lock, json_mutex_callback_t unlock, json_mutex_callback_t destroy, void * manager_lock);
+ #else
+ LIBJSON_DLL void json_register_mutex_callbacks(json_mutex_callback_t lock, json_mutex_callback_t unlock, void * manager_lock);
+ #endif
+ LIBJSON_DLL void json_set_global_mutex(void * mutex);
+ LIBJSON_DLL void json_set_mutex(JSONNODE * node, void * mutex);
+ LIBJSON_DLL void json_lock(JSONNODE * node, int threadid);
+ LIBJSON_DLL void json_unlock(JSONNODE * node, int threadid);
+ #endif
+ #ifdef JSON_MEMORY_CALLBACKS
+ LIBJSON_DLL void json_register_memory_callbacks(json_malloc_t mal, json_realloc_t real, json_free_t fre);
+ #endif
+
+
+ /*
+ stuff that's in class JSONNode
+ */
+ //ctors
+ LIBJSON_DLL JSONNODE * json_new_a(const json_char * name, const json_char * value);
+ LIBJSON_DLL JSONNODE * json_new_i(const json_char * name, long value);
+ LIBJSON_DLL JSONNODE * json_new_f(const json_char * name, json_number value);
+ LIBJSON_DLL JSONNODE * json_new_b(const json_char * name, int value); //because C bools are ints and C++ will implicitly cast it
+ LIBJSON_DLL JSONNODE * json_new(char type);
+ LIBJSON_DLL JSONNODE * json_copy(const JSONNODE * orig);
+ LIBJSON_DLL JSONNODE * json_duplicate(const JSONNODE * orig);
+
+ //assignment
+ LIBJSON_DLL void json_set_a(JSONNODE * node, const json_char * value);
+ LIBJSON_DLL void json_set_i(JSONNODE * node, long value);
+ LIBJSON_DLL void json_set_f(JSONNODE * node, json_number value);
+ LIBJSON_DLL void json_set_b(JSONNODE * node, int value); //because C bools are ints ane C++ will implicit
+ LIBJSON_DLL void json_set_n(JSONNODE * node, const JSONNODE * orig);
+
+ //inspectors
+ LIBJSON_DLL char json_type(const JSONNODE * node);
+ LIBJSON_DLL json_index_t json_size(const JSONNODE * node);
+ LIBJSON_DLL int json_empty(const JSONNODE * node);
+ LIBJSON_DLL json_char * json_name(const JSONNODE * node);
+ #ifdef JSON_COMMENTS
+ LIBJSON_DLL json_char * json_get_comment(const JSONNODE * node);
+ #endif
+ LIBJSON_DLL json_char * json_as_string(const JSONNODE * node);
+ LIBJSON_DLL long json_as_int(const JSONNODE * node);
+ LIBJSON_DLL json_number json_as_float(const JSONNODE * node);
+ LIBJSON_DLL int json_as_bool(const JSONNODE * node);
+ LIBJSON_DLL JSONNODE * json_as_node(const JSONNODE * node);
+ LIBJSON_DLL JSONNODE * json_as_array(const JSONNODE * node);
+ #ifdef JSON_BINARY
+ LIBJSON_DLL void * json_as_binary(const JSONNODE * node, unsigned long * size);
+ #endif
+ #ifdef JSON_WRITER
+ LIBJSON_DLL json_char * json_write(const JSONNODE * node);
+ LIBJSON_DLL json_char * json_write_formatted(const JSONNODE * node);
+ #endif
+
+ //modifiers
+ LIBJSON_DLL void json_set_name(JSONNODE * node, const json_char * name);
+ #ifdef JSON_COMMENTS
+ LIBJSON_DLL void json_set_comment(JSONNODE * node, const json_char * comment);
+ #endif
+ LIBJSON_DLL void json_clear(JSONNODE * node);
+ LIBJSON_DLL void json_nullify(JSONNODE * node);
+ LIBJSON_DLL void json_swap(JSONNODE * node, JSONNODE * node2);
+ LIBJSON_DLL void json_merge(JSONNODE * node, JSONNODE * node2);
+ #ifndef JSON_PREPARSE
+ LIBJSON_DLL void json_preparse(JSONNODE * node);
+ #endif
+ #ifdef JSON_BINARY
+ LIBJSON_DLL void json_set_binary(JSONNODE * node, const void * data, unsigned long length);
+ #endif
+ LIBJSON_DLL void json_cast(JSONNODE * node, char type);
+
+ //children access
+ LIBJSON_DLL void json_reserve(JSONNODE * node, json_index_t siz);
+ LIBJSON_DLL JSONNODE * json_at(JSONNODE * node, json_index_t pos);
+ LIBJSON_DLL JSONNODE * json_get(JSONNODE * node, const json_char * name);
+ #ifdef JSON_CASE_INSENSITIVE_FUNCTIONS
+ LIBJSON_DLL JSONNODE * json_get_nocase(JSONNODE * node, const json_char * name);
+ LIBJSON_DLL JSONNODE * json_pop_back_nocase(JSONNODE * node, const json_char * name);
+ #endif
+ LIBJSON_DLL void json_push_back(JSONNODE * node, JSONNODE * node2);
+ LIBJSON_DLL JSONNODE * json_pop_back_at(JSONNODE * node, json_index_t pos);
+ LIBJSON_DLL JSONNODE * json_pop_back(JSONNODE * node, const json_char * name);
+ #ifdef JSON_ITERATORS
+ LIBJSON_DLL JSONNODE_ITERATOR json_find(JSONNODE * node, const json_char * name);
+ #ifdef JSON_CASE_INSENSITIVE_FUNCTIONS
+ LIBJSON_DLL JSONNODE_ITERATOR json_find_nocase(JSONNODE * node, const json_char * name);
+ #endif
+ LIBJSON_DLL JSONNODE_ITERATOR json_erase(JSONNODE * node, JSONNODE_ITERATOR it);
+ LIBJSON_DLL JSONNODE_ITERATOR json_erase_multi(JSONNODE * node, JSONNODE_ITERATOR start, JSONNODE_ITERATOR end);
+ LIBJSON_DLL JSONNODE_ITERATOR json_insert(JSONNODE * node, JSONNODE_ITERATOR it, JSONNODE * node2);
+ LIBJSON_DLL JSONNODE_ITERATOR json_insert_multi(JSONNODE * node, JSONNODE_ITERATOR it, JSONNODE_ITERATOR start, JSONNODE_ITERATOR end);
+
+ //iterator functions
+ LIBJSON_DLL JSONNODE_ITERATOR json_begin(JSONNODE * node);
+ LIBJSON_DLL JSONNODE_ITERATOR json_end(JSONNODE * node);
+ #endif
+
+ //comparison
+ LIBJSON_DLL int json_equal(JSONNODE * node, JSONNODE * node2);
+
+ #ifdef __cplusplus
+ }
+ #endif
+#else
+ #ifndef __cplusplus
+ #error Using the non-library requires C++
+ #endif
+ #include "Source/JSONNode.h" //not used in this file, but libJSON.h should be the only file required to use it embedded
+ #include "Source/JSONWorker.h"
+ #include <stdexcept> //some methods throw exceptions
+
+ namespace libJSON {
+ //if json is invalid, it throws a std::invalid_argument exception
+ inline static JSONNode parse(const json_string & json){
+ return JSONWorker::parse(json);
+ }
+
+ //useful if you have json that you don't want to parse, just want to strip to cut down on space
+ inline static json_string strip_white_space(const json_string & json){
+ return JSONWorker::RemoveWhiteSpaceAndComments(json);
+ }
+
+ //if json is invalid, it throws a std::invalid_argument exception (differs from parse because this checks the entire tree)
+ #ifdef JSON_VALIDATE
+ inline static JSONNode validate(const json_string & json){
+ return JSONWorker::validate(json);
+ }
+ #endif
+
+ //When libjson errors, a callback allows the user to know what went wrong
+ #if defined JSON_DEBUG && !defined JSON_STDERROR
+ inline static void register_debug_callback(json_error_callback_t callback){
+ JSONDebug::register_callback(callback);
+ }
+ #endif
+
+ #ifdef JSON_MUTEX_CALLBACKS
+ #ifdef JSON_MUTEX_MANAGE
+ inline static void register_mutex_callbacks(json_mutex_callback_t lock, json_mutex_callback_t unlock, json_mutex_callback_t destroy, void * manager_lock){
+ JSONNode::register_mutex_callbacks(lock, unlock, manager_lock);
+ JSONNode::register_mutex_destructor(destroy);
+ }
+ #else
+ inline static void register_mutex_callbacks(json_mutex_callback_t lock, json_mutex_callback_t unlock, void * manager_lock){
+ JSONNode::register_mutex_callbacks(lock, unlock, manager_lock);
+ }
+ #endif
+
+ inline static void set_global_mutex(void * mutex){
+ JSONNode::set_global_mutex(mutex);
+ }
+ #endif
+
+ #ifdef JSON_MEMORY_CALLBACKS
+ inline static void register_memory_callbacks(json_malloc_t mal, json_realloc_t real, json_free_t fre){
+ JSONMemory::registerMemoryCallbacks(mal, real, fre);
+ }
+ #endif
+
+ }
+#endif //JSON_LIBRARY
+
+#endif //LIBJSON_H