2017-02-28 00:53:15 +00:00
/*
Copyright ( c ) 2009 Dave Gamble
Permission is hereby granted , free of charge , to any person obtaining a copy
of this software and associated documentation files ( the " Software " ) , to deal
in the Software without restriction , including without limitation the rights
to use , copy , modify , merge , publish , distribute , sublicense , and / or sell
copies of the Software , and to permit persons to whom the Software is
furnished to do so , subject to the following conditions :
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software .
THE SOFTWARE IS PROVIDED " AS IS " , WITHOUT WARRANTY OF ANY KIND , EXPRESS OR
IMPLIED , INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY ,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT . IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM , DAMAGES OR OTHER
LIABILITY , WHETHER IN AN ACTION OF CONTRACT , TORT OR OTHERWISE , ARISING FROM ,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE .
*/
# ifndef cJSON__h
# define cJSON__h
# ifdef __cplusplus
extern " C "
{
# endif
/* project version */
# define CJSON_VERSION_MAJOR 1
# define CJSON_VERSION_MINOR 3
# define CJSON_VERSION_PATCH 0
# include <stddef.h>
/* cJSON Types: */
# define cJSON_Invalid (0)
# define cJSON_False (1 << 0)
# define cJSON_True (1 << 1)
# define cJSON_NULL (1 << 2)
# define cJSON_Number (1 << 3)
# define cJSON_String (1 << 4)
# define cJSON_Array (1 << 5)
# define cJSON_Object (1 << 6)
# define cJSON_Raw (1 << 7) /* raw json */
# define cJSON_IsReference 256
# define cJSON_StringIsConst 512
/* The cJSON structure: */
typedef struct cJSON
{
/* next/prev allow you to walk array/object chains. Alternatively, use GetArraySize/GetArrayItem/GetObjectItem */
struct cJSON * next ;
struct cJSON * prev ;
/* An array or object item will have a child pointer pointing to a chain of the items in the array/object. */
struct cJSON * child ;
/* The type of the item, as above. */
int type ;
/* The item's string, if type==cJSON_String and type == cJSON_Raw */
char * valuestring ;
/* The item's number, if type==cJSON_Number */
int valueint ;
/* The item's number, if type==cJSON_Number */
double valuedouble ;
/* The item's name string, if this item is the child of, or is in the list of subitems of an object. */
char * string ;
} cJSON ;
typedef struct cJSON_Hooks
{
void * ( * malloc_fn ) ( size_t sz ) ;
void ( * free_fn ) ( void * ptr ) ;
} cJSON_Hooks ;
# if !defined(__WINDOWS__) && (defined(WIN32) || defined(WIN64) || defined(_MSC_VER) || defined(_WIN32))
# define __WINDOWS__
# endif
# ifdef __WINDOWS__
/* When compiling for windows, we specify a specific calling convention to avoid issues where we are being called from a project with a different default calling convention. For windows you have 2 define options:
CJSON_HIDE_SYMBOLS - Define this in the case where you don ' t want to ever dllexport symbols
CJSON_EXPORT_SYMBOLS - Define this on library build when you want to dllexport symbols
For * nix builds that support visibility attribute , you can define similar behavior by
setting default visibility to hidden by adding
- fvisibility = hidden ( for gcc )
or
- xldscope = hidden ( for sun cc )
to CFLAGS
then using the CJSON_API_VISIBILITY flag to " export " the same symbols the way CJSON_EXPORT_SYMBOLS does
*/
# if defined(CJSON_HIDE_SYMBOLS)
# define CJSON_PUBLIC(type) type __stdcall
# elif defined(CJSON_EXPORT_SYMBOLS)
# define CJSON_PUBLIC(type) __declspec(dllexport) type __stdcall
# else
# define CJSON_PUBLIC(type) __declspec(dllimport) type __stdcall
# endif
# else /* !WIN32 */
# if (defined(__GNUC__) || defined(__SUNPRO_CC) || defined (__SUNPRO_C)) && defined(CJSON_API_VISIBILITY)
# define CJSON_PUBLIC(type) __attribute__((visibility("default"))) type
# else
# define CJSON_PUBLIC(type) type
# endif
# endif
/* returns the version of cJSON as a string */
CJSON_PUBLIC ( const char * ) cJSON_Version ( void ) ;
/* Supply malloc, realloc and free functions to cJSON */
CJSON_PUBLIC ( void ) cJSON_InitHooks ( cJSON_Hooks * hooks ) ;
/* Supply a block of JSON, and this returns a cJSON object you can interrogate. Call cJSON_Delete when finished. */
CJSON_PUBLIC ( cJSON * ) cJSON_Parse ( const char * value ) ;
/* Render a cJSON entity to text for transfer/storage. Free the char* when finished. */
CJSON_PUBLIC ( char * ) cJSON_Print ( const cJSON * item ) ;
/* Render a cJSON entity to text for transfer/storage without any formatting. Free the char* when finished. */
CJSON_PUBLIC ( char * ) cJSON_PrintUnformatted ( const cJSON * item ) ;
/* Render a cJSON entity to text using a buffered strategy. prebuffer is a guess at the final size. guessing well reduces reallocation. fmt=0 gives unformatted, =1 gives formatted */
CJSON_PUBLIC ( char * ) cJSON_PrintBuffered ( const cJSON * item , int prebuffer , int fmt ) ;
/* Render a cJSON entity to text using a buffer already allocated in memory with length buf_len. Returns 1 on success and 0 on failure. */
CJSON_PUBLIC ( int ) cJSON_PrintPreallocated ( cJSON * item , char * buf , const int len , const int fmt ) ;
/* Delete a cJSON entity and all subentities. */
CJSON_PUBLIC ( void ) cJSON_Delete ( cJSON * c ) ;
/* Returns the number of items in an array (or object). */
CJSON_PUBLIC ( int ) cJSON_GetArraySize ( const cJSON * array ) ;
/* Retrieve item number "item" from array "array". Returns NULL if unsuccessful. */
CJSON_PUBLIC ( cJSON * ) cJSON_GetArrayItem ( const cJSON * array , int item ) ;
/* Get item "string" from object. Case insensitive. */
CJSON_PUBLIC ( cJSON * ) cJSON_GetObjectItem ( const cJSON * object , const char * string ) ;
2017-03-15 21:13:40 +00:00
CJSON_PUBLIC ( cJSON * ) cJSON_GetObjectItemCaseSensitive ( const cJSON * const object , const char * const string ) ;
2017-02-28 00:53:15 +00:00
CJSON_PUBLIC ( int ) cJSON_HasObjectItem ( const cJSON * object , const char * string ) ;
/* For analysing failed parses. This returns a pointer to the parse error. You'll probably need to look a few chars back to make sense of it. Defined when cJSON_Parse() returns 0. 0 when cJSON_Parse() succeeds. */
CJSON_PUBLIC ( const char * ) cJSON_GetErrorPtr ( void ) ;
/* These calls create a cJSON item of the appropriate type. */
CJSON_PUBLIC ( cJSON * ) cJSON_CreateNull ( void ) ;
CJSON_PUBLIC ( cJSON * ) cJSON_CreateTrue ( void ) ;
CJSON_PUBLIC ( cJSON * ) cJSON_CreateFalse ( void ) ;
CJSON_PUBLIC ( cJSON * ) cJSON_CreateBool ( int b ) ;
CJSON_PUBLIC ( cJSON * ) cJSON_CreateNumber ( double num ) ;
CJSON_PUBLIC ( cJSON * ) cJSON_CreateString ( const char * string ) ;
/* raw json */
CJSON_PUBLIC ( cJSON * ) cJSON_CreateRaw ( const char * raw ) ;
CJSON_PUBLIC ( cJSON * ) cJSON_CreateArray ( void ) ;
CJSON_PUBLIC ( cJSON * ) cJSON_CreateObject ( void ) ;
/* These utilities create an Array of count items. */
CJSON_PUBLIC ( cJSON * ) cJSON_CreateIntArray ( const int * numbers , int count ) ;
CJSON_PUBLIC ( cJSON * ) cJSON_CreateFloatArray ( const float * numbers , int count ) ;
CJSON_PUBLIC ( cJSON * ) cJSON_CreateDoubleArray ( const double * numbers , int count ) ;
CJSON_PUBLIC ( cJSON * ) cJSON_CreateStringArray ( const char * * strings , int count ) ;
/* Append item to the specified array/object. */
CJSON_PUBLIC ( void ) cJSON_AddItemToArray ( cJSON * array , cJSON * item ) ;
CJSON_PUBLIC ( void ) cJSON_AddItemToObject ( cJSON * object , const char * string , cJSON * item ) ;
/* Use this when string is definitely const (i.e. a literal, or as good as), and will definitely survive the cJSON object.
* WARNING : When this function was used , make sure to always check that ( item - > type & cJSON_StringIsConst ) is zero before
* writing to ` item - > string ` */
CJSON_PUBLIC ( void ) cJSON_AddItemToObjectCS ( cJSON * object , const char * string , cJSON * item ) ;
/* Append reference to item to the specified array/object. Use this when you want to add an existing cJSON to a new cJSON, but don't want to corrupt your existing cJSON. */
CJSON_PUBLIC ( void ) cJSON_AddItemReferenceToArray ( cJSON * array , cJSON * item ) ;
CJSON_PUBLIC ( void ) cJSON_AddItemReferenceToObject ( cJSON * object , const char * string , cJSON * item ) ;
/* Remove/Detatch items from Arrays/Objects. */
CJSON_PUBLIC ( cJSON * ) cJSON_DetachItemFromArray ( cJSON * array , int which ) ;
CJSON_PUBLIC ( void ) cJSON_DeleteItemFromArray ( cJSON * array , int which ) ;
CJSON_PUBLIC ( cJSON * ) cJSON_DetachItemFromObject ( cJSON * object , const char * string ) ;
CJSON_PUBLIC ( void ) cJSON_DeleteItemFromObject ( cJSON * object , const char * string ) ;
/* Update array items. */
CJSON_PUBLIC ( void ) cJSON_InsertItemInArray ( cJSON * array , int which , cJSON * newitem ) ; /* Shifts pre-existing items to the right. */
CJSON_PUBLIC ( void ) cJSON_ReplaceItemInArray ( cJSON * array , int which , cJSON * newitem ) ;
CJSON_PUBLIC ( void ) cJSON_ReplaceItemInObject ( cJSON * object , const char * string , cJSON * newitem ) ;
/* Duplicate a cJSON item */
CJSON_PUBLIC ( cJSON * ) cJSON_Duplicate ( const cJSON * item , int recurse ) ;
/* Duplicate will create a new, identical cJSON item to the one you pass, in new memory that will
need to be released . With recurse ! = 0 , it will duplicate any children connected to the item .
The item - > next and - > prev pointers are always zero on return from Duplicate . */
/* ParseWithOpts allows you to require (and check) that the JSON is null terminated, and to retrieve the pointer to the final byte parsed. */
/* If you supply a ptr in return_parse_end and parsing fails, then return_parse_end will contain a pointer to the error. If not, then cJSON_GetErrorPtr() does the job. */
CJSON_PUBLIC ( cJSON * ) cJSON_ParseWithOpts ( const char * value , const char * * return_parse_end , int require_null_terminated ) ;
CJSON_PUBLIC ( void ) cJSON_Minify ( char * json ) ;
/* Macros for creating things quickly. */
# define cJSON_AddNullToObject(object,name) cJSON_AddItemToObject(object, name, cJSON_CreateNull())
# define cJSON_AddTrueToObject(object,name) cJSON_AddItemToObject(object, name, cJSON_CreateTrue())
# define cJSON_AddFalseToObject(object,name) cJSON_AddItemToObject(object, name, cJSON_CreateFalse())
# define cJSON_AddBoolToObject(object,name,b) cJSON_AddItemToObject(object, name, cJSON_CreateBool(b))
# define cJSON_AddNumberToObject(object,name,n) cJSON_AddItemToObject(object, name, cJSON_CreateNumber(n))
# define cJSON_AddStringToObject(object,name,s) cJSON_AddItemToObject(object, name, cJSON_CreateString(s))
# define cJSON_AddRawToObject(object,name,s) cJSON_AddItemToObject(object, name, cJSON_CreateRaw(s))
/* When assigning an integer value, it needs to be propagated to valuedouble too. */
# define cJSON_SetIntValue(object, number) ((object) ? (object)->valueint = (object)->valuedouble = (number) : (number))
/* helper for the cJSON_SetNumberValue macro */
CJSON_PUBLIC ( double ) cJSON_SetNumberHelper ( cJSON * object , double number ) ;
# define cJSON_SetNumberValue(object, number) ((object != NULL) ? cJSON_SetNumberHelper(object, (double)number) : (number))
/* Macro for iterating over an array */
# define cJSON_ArrayForEach(element, array) for(element = (array != NULL) ? (array)->child : NULL; element != NULL; element = element->next)
# ifdef __cplusplus
}
# endif
# endif