libjson interface added to the core

git-svn-id: http://svn.miranda-ng.org/main/trunk@573 1316c22d-e87f-b044-9b9b-93d7a3e3ba9c

1 files changed, 212 insertions, 0 deletions

diff --git a/src/modules/json/libJSON.h b/src/modules/json/libJSON.h
new file mode 100644
index 0000000000..3e60fd502a
--- /dev/null
+++ b/src/modules/json/libJSON.h
@@ -0,0 +1,212 @@
+#ifndef LIBJSON_H
+#define LIBJSON_H
+
+#include "JSONDefs.h"  //for typedefs of functions, strings, and nodes
+
+#ifdef _STATIC
+#define LIBJSON_DLL
+#elif 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 "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 "JSONNode.h"  //not used in this file, but libJSON.h should be the only file required to use it embedded
+    #include "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