]> granicus.if.org Git - esp-idf/commitdiff
components/json: add JSON parse feature
authorliuhan <liuhan@espressif.com>
Thu, 25 Aug 2016 09:04:14 +0000 (17:04 +0800)
committerliuhan <liuhan@espressif.com>
Thu, 25 Aug 2016 09:04:14 +0000 (17:04 +0800)
Develop and Compile JSON Parse function, see json file.

components/json/LICENSE [new file with mode: 0644]
components/json/Makefile [new file with mode: 0644]
components/json/README [new file with mode: 0644]
components/json/include/cJSON.h [new file with mode: 0644]
components/json/library/cJSON.c [new file with mode: 0644]
components/json/port/cJSON_Utils.c [new file with mode: 0644]
components/json/port/include/cJSON_Utils.h [new file with mode: 0644]

diff --git a/components/json/LICENSE b/components/json/LICENSE
new file mode 100644 (file)
index 0000000..fa0a438
--- /dev/null
@@ -0,0 +1,20 @@
+  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.
+
diff --git a/components/json/Makefile b/components/json/Makefile
new file mode 100644 (file)
index 0000000..ebddafd
--- /dev/null
@@ -0,0 +1,13 @@
+#
+# Component Makefile
+#
+# This Makefile should, at the very least, just include $(SDK_PATH)/Makefile. By default, 
+# this will take the sources in this directory, compile them and link them into 
+# lib(subdirectory_name).a in the build directory. This behaviour is entirely configurable,
+# please read the SDK documents if you need to do this.
+#
+COMPONENT_ADD_INCLUDEDIRS := include port/include
+
+COMPONENT_SRCDIRS := library port
+
+include $(IDF_PATH)/make/component.mk
diff --git a/components/json/README b/components/json/README
new file mode 100644 (file)
index 0000000..a5e0bf0
--- /dev/null
@@ -0,0 +1,247 @@
+/*
+  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.
+*/
+
+Welcome to cJSON.
+
+cJSON aims to be the dumbest possible parser that you can get your job done with.
+It's a single file of C, and a single header file.
+
+JSON is described best here: http://www.json.org/
+It's like XML, but fat-free. You use it to move data around, store things, or just
+generally represent your program's state.
+
+
+First up, how do I build?
+Add cJSON.c to your project, and put cJSON.h somewhere in the header search path.
+For example, to build the test app:
+
+gcc cJSON.c test.c -o test -lm
+./test
+
+
+As a library, cJSON exists to take away as much legwork as it can, but not get in your way.
+As a point of pragmatism (i.e. ignoring the truth), I'm going to say that you can use it
+in one of two modes: Auto and Manual. Let's have a quick run-through.
+
+
+I lifted some JSON from this page: http://www.json.org/fatfree.html
+That page inspired me to write cJSON, which is a parser that tries to share the same
+philosophy as JSON itself. Simple, dumb, out of the way.
+
+Some JSON:
+{
+    "name": "Jack (\"Bee\") Nimble", 
+    "format": {
+        "type":       "rect", 
+        "width":      1920, 
+        "height":     1080, 
+        "interlace":  false, 
+        "frame rate": 24
+    }
+}
+
+Assume that you got this from a file, a webserver, or magic JSON elves, whatever,
+you have a char * to it. Everything is a cJSON struct.
+Get it parsed:
+       cJSON *root = cJSON_Parse(my_json_string);
+
+This is an object. We're in C. We don't have objects. But we do have structs.
+What's the framerate?
+
+       cJSON *format = cJSON_GetObjectItem(root,"format");
+       int framerate = cJSON_GetObjectItem(format,"frame rate")->valueint;
+
+
+Want to change the framerate?
+       cJSON_GetObjectItem(format,"frame rate")->valueint=25;
+       
+Back to disk?
+       char *rendered=cJSON_Print(root);
+
+Finished? Delete the root (this takes care of everything else).
+       cJSON_Delete(root);
+
+That's AUTO mode. If you're going to use Auto mode, you really ought to check pointers
+before you dereference them. If you want to see how you'd build this struct in code?
+       cJSON *root,*fmt;
+       root=cJSON_CreateObject();      
+       cJSON_AddItemToObject(root, "name", cJSON_CreateString("Jack (\"Bee\") Nimble"));
+       cJSON_AddItemToObject(root, "format", fmt=cJSON_CreateObject());
+       cJSON_AddStringToObject(fmt,"type",             "rect");
+       cJSON_AddNumberToObject(fmt,"width",            1920);
+       cJSON_AddNumberToObject(fmt,"height",           1080);
+       cJSON_AddFalseToObject (fmt,"interlace");
+       cJSON_AddNumberToObject(fmt,"frame rate",       24);
+
+Hopefully we can agree that's not a lot of code? There's no overhead, no unnecessary setup.
+Look at test.c for a bunch of nice examples, mostly all ripped off the json.org site, and
+a few from elsewhere.
+
+What about manual mode? First up you need some detail.
+Let's cover how the cJSON objects represent the JSON data.
+cJSON doesn't distinguish arrays from objects in handling; just type.
+Each cJSON has, potentially, a child, siblings, value, a name.
+
+The root object has: Object Type and a Child
+The Child has name "name", with value "Jack ("Bee") Nimble", and a sibling:
+Sibling has type Object, name "format", and a child.
+That child has type String, name "type", value "rect", and a sibling:
+Sibling has type Number, name "width", value 1920, and a sibling:
+Sibling has type Number, name "height", value 1080, and a sibling:
+Sibling has type False, name "interlace", and a sibling:
+Sibling has type Number, name "frame rate", value 24
+
+Here's the structure:
+typedef struct cJSON {
+       struct cJSON *next,*prev;
+       struct cJSON *child;
+
+       int type;
+
+       char *valuestring;
+       int valueint;
+       double valuedouble;
+
+       char *string;
+} cJSON;
+
+By default all values are 0 unless set by virtue of being meaningful.
+
+next/prev is a doubly linked list of siblings. next takes you to your sibling,
+prev takes you back from your sibling to you.
+Only objects and arrays have a "child", and it's the head of the doubly linked list.
+A "child" entry will have prev==0, but next potentially points on. The last sibling has next=0.
+The type expresses Null/True/False/Number/String/Array/Object, all of which are #defined in
+cJSON.h
+
+A Number has valueint and valuedouble. If you're expecting an int, read valueint, if not read
+valuedouble.
+
+Any entry which is in the linked list which is the child of an object will have a "string"
+which is the "name" of the entry. When I said "name" in the above example, that's "string".
+"string" is the JSON name for the 'variable name' if you will.
+
+Now you can trivially walk the lists, recursively, and parse as you please.
+You can invoke cJSON_Parse to get cJSON to parse for you, and then you can take
+the root object, and traverse the structure (which is, formally, an N-tree),
+and tokenise as you please. If you wanted to build a callback style parser, this is how
+you'd do it (just an example, since these things are very specific):
+
+void parse_and_callback(cJSON *item,const char *prefix)
+{
+       while (item)
+       {
+               char *newprefix=malloc(strlen(prefix)+strlen(item->name)+2);
+               sprintf(newprefix,"%s/%s",prefix,item->name);
+               int dorecurse=callback(newprefix, item->type, item);
+               if (item->child && dorecurse) parse_and_callback(item->child,newprefix);
+               item=item->next;
+               free(newprefix);
+       }
+}
+
+The prefix process will build you a separated list, to simplify your callback handling.
+The 'dorecurse' flag would let the callback decide to handle sub-arrays on it's own, or
+let you invoke it per-item. For the item above, your callback might look like this:
+
+int callback(const char *name,int type,cJSON *item)
+{
+       if (!strcmp(name,"name"))       { /* populate name */ }
+       else if (!strcmp(name,"format/type")    { /* handle "rect" */ }
+       else if (!strcmp(name,"format/width")   { /* 800 */ }
+       else if (!strcmp(name,"format/height")  { /* 600 */ }
+       else if (!strcmp(name,"format/interlace")       { /* false */ }
+       else if (!strcmp(name,"format/frame rate")      { /* 24 */ }
+       return 1;
+}
+
+Alternatively, you might like to parse iteratively.
+You'd use:
+
+void parse_object(cJSON *item)
+{
+       int i; for (i=0;i<cJSON_GetArraySize(item);i++)
+       {
+               cJSON *subitem=cJSON_GetArrayItem(item,i);
+               // handle subitem.      
+       }
+}
+
+Or, for PROPER manual mode:
+
+void parse_object(cJSON *item)
+{
+       cJSON *subitem=item->child;
+       while (subitem)
+       {
+               // handle subitem
+               if (subitem->child) parse_object(subitem->child);
+               
+               subitem=subitem->next;
+       }
+}
+
+Of course, this should look familiar, since this is just a stripped-down version
+of the callback-parser.
+
+This should cover most uses you'll find for parsing. The rest should be possible
+to infer.. and if in doubt, read the source! There's not a lot of it! ;)
+
+
+In terms of constructing JSON data, the example code above is the right way to do it.
+You can, of course, hand your sub-objects to other functions to populate.
+Also, if you find a use for it, you can manually build the objects.
+For instance, suppose you wanted to build an array of objects?
+
+cJSON *objects[24];
+
+cJSON *Create_array_of_anything(cJSON **items,int num)
+{
+       int i;cJSON *prev, *root=cJSON_CreateArray();
+       for (i=0;i<24;i++)
+       {
+               if (!i) root->child=objects[i];
+               else    prev->next=objects[i], objects[i]->prev=prev;
+               prev=objects[i];
+       }
+       return root;
+}
+       
+and simply: Create_array_of_anything(objects,24);
+
+cJSON doesn't make any assumptions about what order you create things in.
+You can attach the objects, as above, and later add children to each
+of those objects.
+
+As soon as you call cJSON_Print, it renders the structure to text.
+
+
+
+The test.c code shows how to handle a bunch of typical cases. If you uncomment
+the code, it'll load, parse and print a bunch of test files, also from json.org,
+which are more complex than I'd care to try and stash into a const char array[].
+
+
+Enjoy cJSON!
+
+
+- Dave Gamble, Aug 2009
diff --git a/components/json/include/cJSON.h b/components/json/include/cJSON.h
new file mode 100644 (file)
index 0000000..466d10d
--- /dev/null
@@ -0,0 +1,149 @@
+/*
+  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
+
+/* cJSON Types: */
+#define cJSON_False 0
+#define cJSON_True 1
+#define cJSON_NULL 2
+#define cJSON_Number 3
+#define cJSON_String 4
+#define cJSON_Array 5
+#define cJSON_Object 6
+       
+#define cJSON_IsReference 256
+#define cJSON_StringIsConst 512
+
+/* The cJSON structure: */
+typedef struct cJSON {
+       struct cJSON *next,*prev;       /* next/prev allow you to walk array/object chains. Alternatively, use GetArraySize/GetArrayItem/GetObjectItem */
+       struct cJSON *child;            /* An array or object item will have a child pointer pointing to a chain of the items in the array/object. */
+
+       int type;                                       /* The type of the item, as above. */
+
+       char *valuestring;                      /* The item's string, if type==cJSON_String */
+       int valueint;                           /* The item's number, if type==cJSON_Number */
+       double valuedouble;                     /* The item's number, if type==cJSON_Number */
+
+       char *string;                           /* The item's name string, if this item is the child of, or is in the list of subitems of an object. */
+} cJSON;
+
+typedef struct cJSON_Hooks {
+      void *(*malloc_fn)(size_t sz);
+      void (*free_fn)(void *ptr);
+} cJSON_Hooks;
+
+/* Supply malloc, realloc and free functions to cJSON */
+extern 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. */
+extern cJSON *cJSON_Parse(const char *value);
+/* Render a cJSON entity to text for transfer/storage. Free the char* when finished. */
+extern char  *cJSON_Print(cJSON *item);
+/* Render a cJSON entity to text for transfer/storage without any formatting. Free the char* when finished. */
+extern char  *cJSON_PrintUnformatted(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 */
+extern char *cJSON_PrintBuffered(cJSON *item,int prebuffer,int fmt);
+/* Delete a cJSON entity and all subentities. */
+extern void   cJSON_Delete(cJSON *c);
+
+/* Returns the number of items in an array (or object). */
+extern int       cJSON_GetArraySize(cJSON *array);
+/* Retrieve item number "item" from array "array". Returns NULL if unsuccessful. */
+extern cJSON *cJSON_GetArrayItem(cJSON *array,int item);
+/* Get item "string" from object. Case insensitive. */
+extern cJSON *cJSON_GetObjectItem(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. */
+extern const char *cJSON_GetErrorPtr(void);
+       
+/* These calls create a cJSON item of the appropriate type. */
+extern cJSON *cJSON_CreateNull(void);
+extern cJSON *cJSON_CreateTrue(void);
+extern cJSON *cJSON_CreateFalse(void);
+extern cJSON *cJSON_CreateBool(int b);
+extern cJSON *cJSON_CreateNumber(double num);
+extern cJSON *cJSON_CreateString(const char *string);
+extern cJSON *cJSON_CreateArray(void);
+extern cJSON *cJSON_CreateObject(void);
+
+/* These utilities create an Array of count items. */
+extern cJSON *cJSON_CreateIntArray(const int *numbers,int count);
+extern cJSON *cJSON_CreateFloatArray(const float *numbers,int count);
+extern cJSON *cJSON_CreateDoubleArray(const double *numbers,int count);
+extern cJSON *cJSON_CreateStringArray(const char **strings,int count);
+
+/* Append item to the specified array/object. */
+extern void cJSON_AddItemToArray(cJSON *array, cJSON *item);
+extern void    cJSON_AddItemToObject(cJSON *object,const char *string,cJSON *item);
+extern void    cJSON_AddItemToObjectCS(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 */
+/* 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. */
+extern void cJSON_AddItemReferenceToArray(cJSON *array, cJSON *item);
+extern void    cJSON_AddItemReferenceToObject(cJSON *object,const char *string,cJSON *item);
+
+/* Remove/Detatch items from Arrays/Objects. */
+extern cJSON *cJSON_DetachItemFromArray(cJSON *array,int which);
+extern void   cJSON_DeleteItemFromArray(cJSON *array,int which);
+extern cJSON *cJSON_DetachItemFromObject(cJSON *object,const char *string);
+extern void   cJSON_DeleteItemFromObject(cJSON *object,const char *string);
+       
+/* Update array items. */
+extern void cJSON_InsertItemInArray(cJSON *array,int which,cJSON *newitem);    /* Shifts pre-existing items to the right. */
+extern void cJSON_ReplaceItemInArray(cJSON *array,int which,cJSON *newitem);
+extern void cJSON_ReplaceItemInObject(cJSON *object,const char *string,cJSON *newitem);
+
+/* Duplicate a cJSON item */
+extern cJSON *cJSON_Duplicate(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. */
+extern cJSON *cJSON_ParseWithOpts(const char *value,const char **return_parse_end,int require_null_terminated);
+
+extern 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))
+
+/* When assigning an integer value, it needs to be propagated to valuedouble too. */
+#define cJSON_SetIntValue(object,val)                  ((object)?(object)->valueint=(object)->valuedouble=(val):(val))
+#define cJSON_SetNumberValue(object,val)               ((object)?(object)->valueint=(object)->valuedouble=(val):(val))
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif
diff --git a/components/json/library/cJSON.c b/components/json/library/cJSON.c
new file mode 100644 (file)
index 0000000..ab30437
--- /dev/null
@@ -0,0 +1,750 @@
+/*
+  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.
+*/
+
+/* cJSON */
+/* JSON parser in C. */
+
+#include <string.h>
+#include <stdio.h>
+#include <math.h>
+#include <stdlib.h>
+#include <float.h>
+#include <limits.h>
+#include <ctype.h>
+#include "cJSON.h"
+
+static const char *ep;
+
+const char *cJSON_GetErrorPtr(void) {return ep;}
+
+static int cJSON_strcasecmp(const char *s1,const char *s2)
+{
+       if (!s1) return (s1==s2)?0:1;if (!s2) return 1;
+       for(; tolower(*(const unsigned char *)s1) == tolower(*(const unsigned char *)s2); ++s1, ++s2)   if(*s1 == 0)    return 0;
+       return tolower(*(const unsigned char *)s1) - tolower(*(const unsigned char *)s2);
+}
+
+static void *(*cJSON_malloc)(size_t sz) = malloc;
+static void (*cJSON_free)(void *ptr) = free;
+
+static char* cJSON_strdup(const char* str)
+{
+      size_t len;
+      char* copy;
+
+      len = strlen(str) + 1;
+      if (!(copy = (char*)cJSON_malloc(len))) return 0;
+      memcpy(copy,str,len);
+      return copy;
+}
+
+void cJSON_InitHooks(cJSON_Hooks* hooks)
+{
+    if (!hooks) { /* Reset hooks */
+        cJSON_malloc = malloc;
+        cJSON_free = free;
+        return;
+    }
+
+       cJSON_malloc = (hooks->malloc_fn)?hooks->malloc_fn:malloc;
+       cJSON_free       = (hooks->free_fn)?hooks->free_fn:free;
+}
+
+/* Internal constructor. */
+static cJSON *cJSON_New_Item(void)
+{
+       cJSON* node = (cJSON*)cJSON_malloc(sizeof(cJSON));
+       if (node) memset(node,0,sizeof(cJSON));
+       return node;
+}
+
+/* Delete a cJSON structure. */
+void cJSON_Delete(cJSON *c)
+{
+       cJSON *next;
+       while (c)
+       {
+               next=c->next;
+               if (!(c->type&cJSON_IsReference) && c->child) cJSON_Delete(c->child);
+               if (!(c->type&cJSON_IsReference) && c->valuestring) cJSON_free(c->valuestring);
+               if (!(c->type&cJSON_StringIsConst) && c->string) cJSON_free(c->string);
+               cJSON_free(c);
+               c=next;
+       }
+}
+
+/* Parse the input text to generate a number, and populate the result into item. */
+static const char *parse_number(cJSON *item,const char *num)
+{
+       double n=0,sign=1,scale=0;int subscale=0,signsubscale=1;
+
+       if (*num=='-') sign=-1,num++;   /* Has sign? */
+       if (*num=='0') num++;                   /* is zero */
+       if (*num>='1' && *num<='9')     do      n=(n*10.0)+(*num++ -'0');       while (*num>='0' && *num<='9'); /* Number? */
+       if (*num=='.' && num[1]>='0' && num[1]<='9') {num++;            do      n=(n*10.0)+(*num++ -'0'),scale--; while (*num>='0' && *num<='9');}      /* Fractional part? */
+       if (*num=='e' || *num=='E')             /* Exponent? */
+       {       num++;if (*num=='+') num++;     else if (*num=='-') signsubscale=-1,num++;              /* With sign? */
+               while (*num>='0' && *num<='9') subscale=(subscale*10)+(*num++ - '0');   /* Number? */
+       }
+
+       n=sign*n*pow(10.0,(scale+subscale*signsubscale));       /* number = +/- number.fraction * 10^+/- exponent */
+       
+       item->valuedouble=n;
+       item->valueint=(int)n;
+       item->type=cJSON_Number;
+       return num;
+}
+
+static int pow2gt (int x)      {       --x;    x|=x>>1;        x|=x>>2;        x|=x>>4;        x|=x>>8;        x|=x>>16;       return x+1;     }
+
+typedef struct {char *buffer; int length; int offset; } printbuffer;
+
+static char* ensure(printbuffer *p,int needed)
+{
+       char *newbuffer;int newsize;
+       if (!p || !p->buffer) return 0;
+       needed+=p->offset;
+       if (needed<=p->length) return p->buffer+p->offset;
+
+       newsize=pow2gt(needed);
+       newbuffer=(char*)cJSON_malloc(newsize);
+       if (!newbuffer) {cJSON_free(p->buffer);p->length=0,p->buffer=0;return 0;}
+       if (newbuffer) memcpy(newbuffer,p->buffer,p->length);
+       cJSON_free(p->buffer);
+       p->length=newsize;
+       p->buffer=newbuffer;
+       return newbuffer+p->offset;
+}
+
+static int update(printbuffer *p)
+{
+       char *str;
+       if (!p || !p->buffer) return 0;
+       str=p->buffer+p->offset;
+       return p->offset+strlen(str);
+}
+
+/* Render the number nicely from the given item into a string. */
+static char *print_number(cJSON *item,printbuffer *p)
+{
+       char *str=0;
+       double d=item->valuedouble;
+       if (d==0)
+       {
+               if (p)  str=ensure(p,2);
+               else    str=(char*)cJSON_malloc(2);     /* special case for 0. */
+               if (str) strcpy(str,"0");
+       }
+       else if (fabs(((double)item->valueint)-d)<=DBL_EPSILON && d<=INT_MAX && d>=INT_MIN)
+       {
+               if (p)  str=ensure(p,21);
+               else    str=(char*)cJSON_malloc(21);    /* 2^64+1 can be represented in 21 chars. */
+               if (str)        sprintf(str,"%d",item->valueint);
+       }
+       else
+       {
+               if (p)  str=ensure(p,64);
+               else    str=(char*)cJSON_malloc(64);    /* This is a nice tradeoff. */
+               if (str)
+               {
+                       if (fabs(floor(d)-d)<=DBL_EPSILON && fabs(d)<1.0e60)sprintf(str,"%.0f",d);
+                       else if (fabs(d)<1.0e-6 || fabs(d)>1.0e9)                       sprintf(str,"%e",d);
+                       else                                                                                            sprintf(str,"%f",d);
+               }
+       }
+       return str;
+}
+
+static unsigned parse_hex4(const char *str)
+{
+       unsigned h=0;
+       if (*str>='0' && *str<='9') h+=(*str)-'0'; else if (*str>='A' && *str<='F') h+=10+(*str)-'A'; else if (*str>='a' && *str<='f') h+=10+(*str)-'a'; else return 0;
+       h=h<<4;str++;
+       if (*str>='0' && *str<='9') h+=(*str)-'0'; else if (*str>='A' && *str<='F') h+=10+(*str)-'A'; else if (*str>='a' && *str<='f') h+=10+(*str)-'a'; else return 0;
+       h=h<<4;str++;
+       if (*str>='0' && *str<='9') h+=(*str)-'0'; else if (*str>='A' && *str<='F') h+=10+(*str)-'A'; else if (*str>='a' && *str<='f') h+=10+(*str)-'a'; else return 0;
+       h=h<<4;str++;
+       if (*str>='0' && *str<='9') h+=(*str)-'0'; else if (*str>='A' && *str<='F') h+=10+(*str)-'A'; else if (*str>='a' && *str<='f') h+=10+(*str)-'a'; else return 0;
+       return h;
+}
+
+/* Parse the input text into an unescaped cstring, and populate item. */
+static const unsigned char firstByteMark[7] = { 0x00, 0x00, 0xC0, 0xE0, 0xF0, 0xF8, 0xFC };
+static const char *parse_string(cJSON *item,const char *str)
+{
+       const char *ptr=str+1;char *ptr2;char *out;int len=0;unsigned uc,uc2;
+       if (*str!='\"') {ep=str;return 0;}      /* not a string! */
+       
+       while (*ptr!='\"' && *ptr && ++len) if (*ptr++ == '\\') ptr++;  /* Skip escaped quotes. */
+       
+       out=(char*)cJSON_malloc(len+1); /* This is how long we need for the string, roughly. */
+       if (!out) return 0;
+       
+       ptr=str+1;ptr2=out;
+       while (*ptr!='\"' && *ptr)
+       {
+               if (*ptr!='\\') *ptr2++=*ptr++;
+               else
+               {
+                       ptr++;
+                       switch (*ptr)
+                       {
+                               case 'b': *ptr2++='\b'; break;
+                               case 'f': *ptr2++='\f'; break;
+                               case 'n': *ptr2++='\n'; break;
+                               case 'r': *ptr2++='\r'; break;
+                               case 't': *ptr2++='\t'; break;
+                               case 'u':        /* transcode utf16 to utf8. */
+                                       uc=parse_hex4(ptr+1);ptr+=4;    /* get the unicode char. */
+
+                                       if ((uc>=0xDC00 && uc<=0xDFFF) || uc==0)        break;  /* check for invalid.   */
+
+                                       if (uc>=0xD800 && uc<=0xDBFF)   /* UTF16 surrogate pairs.       */
+                                       {
+                                               if (ptr[1]!='\\' || ptr[2]!='u')        break;  /* missing second-half of surrogate.    */
+                                               uc2=parse_hex4(ptr+3);ptr+=6;
+                                               if (uc2<0xDC00 || uc2>0xDFFF)           break;  /* invalid second-half of surrogate.    */
+                                               uc=0x10000 + (((uc&0x3FF)<<10) | (uc2&0x3FF));
+                                       }
+
+                                       len=4;if (uc<0x80) len=1;else if (uc<0x800) len=2;else if (uc<0x10000) len=3; ptr2+=len;
+                                       
+                                       switch (len) {
+                                               case 4: *--ptr2 =((uc | 0x80) & 0xBF); uc >>= 6;
+                                               case 3: *--ptr2 =((uc | 0x80) & 0xBF); uc >>= 6;
+                                               case 2: *--ptr2 =((uc | 0x80) & 0xBF); uc >>= 6;
+                                               case 1: *--ptr2 =(uc | firstByteMark[len]);
+                                       }
+                                       ptr2+=len;
+                                       break;
+                               default:  *ptr2++=*ptr; break;
+                       }
+                       ptr++;
+               }
+       }
+       *ptr2=0;
+       if (*ptr=='\"') ptr++;
+       item->valuestring=out;
+       item->type=cJSON_String;
+       return ptr;
+}
+
+/* Render the cstring provided to an escaped version that can be printed. */
+static char *print_string_ptr(const char *str,printbuffer *p)
+{
+       const char *ptr;char *ptr2,*out;int len=0,flag=0;unsigned char token;
+       
+       for (ptr=str;*ptr;ptr++) flag|=((*ptr>0 && *ptr<32)||(*ptr=='\"')||(*ptr=='\\'))?1:0;
+       if (!flag)
+       {
+               len=ptr-str;
+               if (p) out=ensure(p,len+3);
+               else            out=(char*)cJSON_malloc(len+3);
+               if (!out) return 0;
+               ptr2=out;*ptr2++='\"';
+               strcpy(ptr2,str);
+               ptr2[len]='\"';
+               ptr2[len+1]=0;
+               return out;
+       }
+       
+       if (!str)
+       {
+               if (p)  out=ensure(p,3);
+               else    out=(char*)cJSON_malloc(3);
+               if (!out) return 0;
+               strcpy(out,"\"\"");
+               return out;
+       }
+       ptr=str;while ((token=*ptr) && ++len) {if (strchr("\"\\\b\f\n\r\t",token)) len++; else if (token<32) len+=5;ptr++;}
+       
+       if (p)  out=ensure(p,len+3);
+       else    out=(char*)cJSON_malloc(len+3);
+       if (!out) return 0;
+
+       ptr2=out;ptr=str;
+       *ptr2++='\"';
+       while (*ptr)
+       {
+               if ((unsigned char)*ptr>31 && *ptr!='\"' && *ptr!='\\') *ptr2++=*ptr++;
+               else
+               {
+                       *ptr2++='\\';
+                       switch (token=*ptr++)
+                       {
+                               case '\\':      *ptr2++='\\';   break;
+                               case '\"':      *ptr2++='\"';   break;
+                               case '\b':      *ptr2++='b';    break;
+                               case '\f':      *ptr2++='f';    break;
+                               case '\n':      *ptr2++='n';    break;
+                               case '\r':      *ptr2++='r';    break;
+                               case '\t':      *ptr2++='t';    break;
+                               default: sprintf(ptr2,"u%04x",token);ptr2+=5;   break;  /* escape and print */
+                       }
+               }
+       }
+       *ptr2++='\"';*ptr2++=0;
+       return out;
+}
+/* Invote print_string_ptr (which is useful) on an item. */
+static char *print_string(cJSON *item,printbuffer *p)  {return print_string_ptr(item->valuestring,p);}
+
+/* Predeclare these prototypes. */
+static const char *parse_value(cJSON *item,const char *value);
+static char *print_value(cJSON *item,int depth,int fmt,printbuffer *p);
+static const char *parse_array(cJSON *item,const char *value);
+static char *print_array(cJSON *item,int depth,int fmt,printbuffer *p);
+static const char *parse_object(cJSON *item,const char *value);
+static char *print_object(cJSON *item,int depth,int fmt,printbuffer *p);
+
+/* Utility to jump whitespace and cr/lf */
+static const char *skip(const char *in) {while (in && *in && (unsigned char)*in<=32) in++; return in;}
+
+/* Parse an object - create a new root, and populate. */
+cJSON *cJSON_ParseWithOpts(const char *value,const char **return_parse_end,int require_null_terminated)
+{
+       const char *end=0;
+       cJSON *c=cJSON_New_Item();
+       ep=0;
+       if (!c) return 0;       /* memory fail */
+
+       end=parse_value(c,skip(value));
+       if (!end)       {cJSON_Delete(c);return 0;}     /* parse failure. ep is set. */
+
+       /* if we require null-terminated JSON without appended garbage, skip and then check for a null terminator */
+       if (require_null_terminated) {end=skip(end);if (*end) {cJSON_Delete(c);ep=end;return 0;}}
+       if (return_parse_end) *return_parse_end=end;
+       return c;
+}
+/* Default options for cJSON_Parse */
+cJSON *cJSON_Parse(const char *value) {return cJSON_ParseWithOpts(value,0,0);}
+
+/* Render a cJSON item/entity/structure to text. */
+char *cJSON_Print(cJSON *item)                         {return print_value(item,0,1,0);}
+char *cJSON_PrintUnformatted(cJSON *item)      {return print_value(item,0,0,0);}
+
+char *cJSON_PrintBuffered(cJSON *item,int prebuffer,int fmt)
+{
+       printbuffer p;
+       p.buffer=(char*)cJSON_malloc(prebuffer);
+       p.length=prebuffer;
+       p.offset=0;
+       return print_value(item,0,fmt,&p);
+       return p.buffer;
+}
+
+
+/* Parser core - when encountering text, process appropriately. */
+static const char *parse_value(cJSON *item,const char *value)
+{
+       if (!value)                                             return 0;       /* Fail on null. */
+       if (!strncmp(value,"null",4))   { item->type=cJSON_NULL;  return value+4; }
+       if (!strncmp(value,"false",5))  { item->type=cJSON_False; return value+5; }
+       if (!strncmp(value,"true",4))   { item->type=cJSON_True; item->valueint=1;      return value+4; }
+       if (*value=='\"')                               { return parse_string(item,value); }
+       if (*value=='-' || (*value>='0' && *value<='9'))        { return parse_number(item,value); }
+       if (*value=='[')                                { return parse_array(item,value); }
+       if (*value=='{')                                { return parse_object(item,value); }
+
+       ep=value;return 0;      /* failure. */
+}
+
+/* Render a value to text. */
+static char *print_value(cJSON *item,int depth,int fmt,printbuffer *p)
+{
+       char *out=0;
+       if (!item) return 0;
+       if (p)
+       {
+               switch ((item->type)&255)
+               {
+                       case cJSON_NULL:        {out=ensure(p,5);       if (out) strcpy(out,"null");    break;}
+                       case cJSON_False:       {out=ensure(p,6);       if (out) strcpy(out,"false");   break;}
+                       case cJSON_True:        {out=ensure(p,5);       if (out) strcpy(out,"true");    break;}
+                       case cJSON_Number:      out=print_number(item,p);break;
+                       case cJSON_String:      out=print_string(item,p);break;
+                       case cJSON_Array:       out=print_array(item,depth,fmt,p);break;
+                       case cJSON_Object:      out=print_object(item,depth,fmt,p);break;
+               }
+       }
+       else
+       {
+               switch ((item->type)&255)
+               {
+                       case cJSON_NULL:        out=cJSON_strdup("null");       break;
+                       case cJSON_False:       out=cJSON_strdup("false");break;
+                       case cJSON_True:        out=cJSON_strdup("true"); break;
+                       case cJSON_Number:      out=print_number(item,0);break;
+                       case cJSON_String:      out=print_string(item,0);break;
+                       case cJSON_Array:       out=print_array(item,depth,fmt,0);break;
+                       case cJSON_Object:      out=print_object(item,depth,fmt,0);break;
+               }
+       }
+       return out;
+}
+
+/* Build an array from input text. */
+static const char *parse_array(cJSON *item,const char *value)
+{
+       cJSON *child;
+       if (*value!='[')        {ep=value;return 0;}    /* not an array! */
+
+       item->type=cJSON_Array;
+       value=skip(value+1);
+       if (*value==']') return value+1;        /* empty array. */
+
+       item->child=child=cJSON_New_Item();
+       if (!item->child) return 0;              /* memory fail */
+       value=skip(parse_value(child,skip(value)));     /* skip any spacing, get the value. */
+       if (!value) return 0;
+
+       while (*value==',')
+       {
+               cJSON *new_item;
+               if (!(new_item=cJSON_New_Item())) return 0;     /* memory fail */
+               child->next=new_item;new_item->prev=child;child=new_item;
+               value=skip(parse_value(child,skip(value+1)));
+               if (!value) return 0;   /* memory fail */
+       }
+
+       if (*value==']') return value+1;        /* end of array */
+       ep=value;return 0;      /* malformed. */
+}
+
+/* Render an array to text */
+static char *print_array(cJSON *item,int depth,int fmt,printbuffer *p)
+{
+       char **entries;
+       char *out=0,*ptr,*ret;int len=5;
+       cJSON *child=item->child;
+       int numentries=0,i=0,fail=0;
+       size_t tmplen=0;
+       
+       /* How many entries in the array? */
+       while (child) numentries++,child=child->next;
+       /* Explicitly handle numentries==0 */
+       if (!numentries)
+       {
+               if (p)  out=ensure(p,3);
+               else    out=(char*)cJSON_malloc(3);
+               if (out) strcpy(out,"[]");
+               return out;
+       }
+
+       if (p)
+       {
+               /* Compose the output array. */
+               i=p->offset;
+               ptr=ensure(p,1);if (!ptr) return 0;     *ptr='[';       p->offset++;
+               child=item->child;
+               while (child && !fail)
+               {
+                       print_value(child,depth+1,fmt,p);
+                       p->offset=update(p);
+                       if (child->next) {len=fmt?2:1;ptr=ensure(p,len+1);if (!ptr) return 0;*ptr++=',';if(fmt)*ptr++=' ';*ptr=0;p->offset+=len;}
+                       child=child->next;
+               }
+               ptr=ensure(p,2);if (!ptr) return 0;     *ptr++=']';*ptr=0;
+               out=(p->buffer)+i;
+       }
+       else
+       {
+               /* Allocate an array to hold the values for each */
+               entries=(char**)cJSON_malloc(numentries*sizeof(char*));
+               if (!entries) return 0;
+               memset(entries,0,numentries*sizeof(char*));
+               /* Retrieve all the results: */
+               child=item->child;
+               while (child && !fail)
+               {
+                       ret=print_value(child,depth+1,fmt,0);
+                       entries[i++]=ret;
+                       if (ret) len+=strlen(ret)+2+(fmt?1:0); else fail=1;
+                       child=child->next;
+               }
+               
+               /* If we didn't fail, try to malloc the output string */
+               if (!fail)      out=(char*)cJSON_malloc(len);
+               /* If that fails, we fail. */
+               if (!out) fail=1;
+
+               /* Handle failure. */
+               if (fail)
+               {
+                       for (i=0;i<numentries;i++) if (entries[i]) cJSON_free(entries[i]);
+                       cJSON_free(entries);
+                       return 0;
+               }
+               
+               /* Compose the output array. */
+               *out='[';
+               ptr=out+1;*ptr=0;
+               for (i=0;i<numentries;i++)
+               {
+                       tmplen=strlen(entries[i]);memcpy(ptr,entries[i],tmplen);ptr+=tmplen;
+                       if (i!=numentries-1) {*ptr++=',';if(fmt)*ptr++=' ';*ptr=0;}
+                       cJSON_free(entries[i]);
+               }
+               cJSON_free(entries);
+               *ptr++=']';*ptr++=0;
+       }
+       return out;     
+}
+
+/* Build an object from the text. */
+static const char *parse_object(cJSON *item,const char *value)
+{
+       cJSON *child;
+       if (*value!='{')        {ep=value;return 0;}    /* not an object! */
+       
+       item->type=cJSON_Object;
+       value=skip(value+1);
+       if (*value=='}') return value+1;        /* empty array. */
+       
+       item->child=child=cJSON_New_Item();
+       if (!item->child) return 0;
+       value=skip(parse_string(child,skip(value)));
+       if (!value) return 0;
+       child->string=child->valuestring;child->valuestring=0;
+       if (*value!=':') {ep=value;return 0;}   /* fail! */
+       value=skip(parse_value(child,skip(value+1)));   /* skip any spacing, get the value. */
+       if (!value) return 0;
+       
+       while (*value==',')
+       {
+               cJSON *new_item;
+               if (!(new_item=cJSON_New_Item()))       return 0; /* memory fail */
+               child->next=new_item;new_item->prev=child;child=new_item;
+               value=skip(parse_string(child,skip(value+1)));
+               if (!value) return 0;
+               child->string=child->valuestring;child->valuestring=0;
+               if (*value!=':') {ep=value;return 0;}   /* fail! */
+               value=skip(parse_value(child,skip(value+1)));   /* skip any spacing, get the value. */
+               if (!value) return 0;
+       }
+       
+       if (*value=='}') return value+1;        /* end of array */
+       ep=value;return 0;      /* malformed. */
+}
+
+/* Render an object to text. */
+static char *print_object(cJSON *item,int depth,int fmt,printbuffer *p)
+{
+       char **entries=0,**names=0;
+       char *out=0,*ptr,*ret,*str;int len=7,i=0,j;
+       cJSON *child=item->child;
+       int numentries=0,fail=0;
+       size_t tmplen=0;
+       /* Count the number of entries. */
+       while (child) numentries++,child=child->next;
+       /* Explicitly handle empty object case */
+       if (!numentries)
+       {
+               if (p) out=ensure(p,fmt?depth+4:3);
+               else    out=(char*)cJSON_malloc(fmt?depth+4:3);
+               if (!out)       return 0;
+               ptr=out;*ptr++='{';
+               if (fmt) {*ptr++='\n';for (i=0;i<depth-1;i++) *ptr++='\t';}
+               *ptr++='}';*ptr++=0;
+               return out;
+       }
+       if (p)
+       {
+               /* Compose the output: */
+               i=p->offset;
+               len=fmt?2:1;    ptr=ensure(p,len+1);    if (!ptr) return 0;
+               *ptr++='{';     if (fmt) *ptr++='\n';   *ptr=0; p->offset+=len;
+               child=item->child;depth++;
+               while (child)
+               {
+                       if (fmt)
+                       {
+                               ptr=ensure(p,depth);    if (!ptr) return 0;
+                               for (j=0;j<depth;j++) *ptr++='\t';
+                               p->offset+=depth;
+                       }
+                       print_string_ptr(child->string,p);
+                       p->offset=update(p);
+                       
+                       len=fmt?2:1;
+                       ptr=ensure(p,len);      if (!ptr) return 0;
+                       *ptr++=':';if (fmt) *ptr++='\t';
+                       p->offset+=len;
+                       
+                       print_value(child,depth,fmt,p);
+                       p->offset=update(p);
+
+                       len=(fmt?1:0)+(child->next?1:0);
+                       ptr=ensure(p,len+1); if (!ptr) return 0;
+                       if (child->next) *ptr++=',';
+                       if (fmt) *ptr++='\n';*ptr=0;
+                       p->offset+=len;
+                       child=child->next;
+               }
+               ptr=ensure(p,fmt?(depth+1):2);   if (!ptr) return 0;
+               if (fmt)        for (i=0;i<depth-1;i++) *ptr++='\t';
+               *ptr++='}';*ptr=0;
+               out=(p->buffer)+i;
+       }
+       else
+       {
+               /* Allocate space for the names and the objects */
+               entries=(char**)cJSON_malloc(numentries*sizeof(char*));
+               if (!entries) return 0;
+               names=(char**)cJSON_malloc(numentries*sizeof(char*));
+               if (!names) {cJSON_free(entries);return 0;}
+               memset(entries,0,sizeof(char*)*numentries);
+               memset(names,0,sizeof(char*)*numentries);
+
+               /* Collect all the results into our arrays: */
+               child=item->child;depth++;if (fmt) len+=depth;
+               while (child)
+               {
+                       names[i]=str=print_string_ptr(child->string,0);
+                       entries[i++]=ret=print_value(child,depth,fmt,0);
+                       if (str && ret) len+=strlen(ret)+strlen(str)+2+(fmt?2+depth:0); else fail=1;
+                       child=child->next;
+               }
+               
+               /* Try to allocate the output string */
+               if (!fail)      out=(char*)cJSON_malloc(len);
+               if (!out) fail=1;
+
+               /* Handle failure */
+               if (fail)
+               {
+                       for (i=0;i<numentries;i++) {if (names[i]) cJSON_free(names[i]);if (entries[i]) cJSON_free(entries[i]);}
+                       cJSON_free(names);cJSON_free(entries);
+                       return 0;
+               }
+               
+               /* Compose the output: */
+               *out='{';ptr=out+1;if (fmt)*ptr++='\n';*ptr=0;
+               for (i=0;i<numentries;i++)
+               {
+                       if (fmt) for (j=0;j<depth;j++) *ptr++='\t';
+                       tmplen=strlen(names[i]);memcpy(ptr,names[i],tmplen);ptr+=tmplen;
+                       *ptr++=':';if (fmt) *ptr++='\t';
+                       strcpy(ptr,entries[i]);ptr+=strlen(entries[i]);
+                       if (i!=numentries-1) *ptr++=',';
+                       if (fmt) *ptr++='\n';*ptr=0;
+                       cJSON_free(names[i]);cJSON_free(entries[i]);
+               }
+               
+               cJSON_free(names);cJSON_free(entries);
+               if (fmt) for (i=0;i<depth-1;i++) *ptr++='\t';
+               *ptr++='}';*ptr++=0;
+       }
+       return out;     
+}
+
+/* Get Array size/item / object item. */
+int    cJSON_GetArraySize(cJSON *array)                                                        {cJSON *c=array->child;int i=0;while(c)i++,c=c->next;return i;}
+cJSON *cJSON_GetArrayItem(cJSON *array,int item)                               {cJSON *c=array->child;  while (c && item>0) item--,c=c->next; return c;}
+cJSON *cJSON_GetObjectItem(cJSON *object,const char *string)   {cJSON *c=object->child; while (c && cJSON_strcasecmp(c->string,string)) c=c->next; return c;}
+
+/* Utility for array list handling. */
+static void suffix_object(cJSON *prev,cJSON *item) {prev->next=item;item->prev=prev;}
+/* Utility for handling references. */
+static cJSON *create_reference(cJSON *item) {cJSON *ref=cJSON_New_Item();if (!ref) return 0;memcpy(ref,item,sizeof(cJSON));ref->string=0;ref->type|=cJSON_IsReference;ref->next=ref->prev=0;return ref;}
+
+/* Add item to array/object. */
+void   cJSON_AddItemToArray(cJSON *array, cJSON *item)                                         {cJSON *c=array->child;if (!item) return; if (!c) {array->child=item;} else {while (c && c->next) c=c->next; suffix_object(c,item);}}
+void   cJSON_AddItemToObject(cJSON *object,const char *string,cJSON *item)     {if (!item) return; if (item->string) cJSON_free(item->string);item->string=cJSON_strdup(string);cJSON_AddItemToArray(object,item);}
+void   cJSON_AddItemToObjectCS(cJSON *object,const char *string,cJSON *item)   {if (!item) return; if (!(item->type&cJSON_StringIsConst) && item->string) cJSON_free(item->string);item->string=(char*)string;item->type|=cJSON_StringIsConst;cJSON_AddItemToArray(object,item);}
+void   cJSON_AddItemReferenceToArray(cJSON *array, cJSON *item)                                                {cJSON_AddItemToArray(array,create_reference(item));}
+void   cJSON_AddItemReferenceToObject(cJSON *object,const char *string,cJSON *item)    {cJSON_AddItemToObject(object,string,create_reference(item));}
+
+cJSON *cJSON_DetachItemFromArray(cJSON *array,int which)                       {cJSON *c=array->child;while (c && which>0) c=c->next,which--;if (!c) return 0;
+       if (c->prev) c->prev->next=c->next;if (c->next) c->next->prev=c->prev;if (c==array->child) array->child=c->next;c->prev=c->next=0;return c;}
+void   cJSON_DeleteItemFromArray(cJSON *array,int which)                       {cJSON_Delete(cJSON_DetachItemFromArray(array,which));}
+cJSON *cJSON_DetachItemFromObject(cJSON *object,const char *string) {int i=0;cJSON *c=object->child;while (c && cJSON_strcasecmp(c->string,string)) i++,c=c->next;if (c) return cJSON_DetachItemFromArray(object,i);return 0;}
+void   cJSON_DeleteItemFromObject(cJSON *object,const char *string) {cJSON_Delete(cJSON_DetachItemFromObject(object,string));}
+
+/* Replace array/object items with new ones. */
+void   cJSON_InsertItemInArray(cJSON *array,int which,cJSON *newitem)          {cJSON *c=array->child;while (c && which>0) c=c->next,which--;if (!c) {cJSON_AddItemToArray(array,newitem);return;}
+       newitem->next=c;newitem->prev=c->prev;c->prev=newitem;if (c==array->child) array->child=newitem; else newitem->prev->next=newitem;}
+void   cJSON_ReplaceItemInArray(cJSON *array,int which,cJSON *newitem)         {cJSON *c=array->child;while (c && which>0) c=c->next,which--;if (!c) return;
+       newitem->next=c->next;newitem->prev=c->prev;if (newitem->next) newitem->next->prev=newitem;
+       if (c==array->child) array->child=newitem; else newitem->prev->next=newitem;c->next=c->prev=0;cJSON_Delete(c);}
+void   cJSON_ReplaceItemInObject(cJSON *object,const char *string,cJSON *newitem){int i=0;cJSON *c=object->child;while(c && cJSON_strcasecmp(c->string,string))i++,c=c->next;if(c){newitem->string=cJSON_strdup(string);cJSON_ReplaceItemInArray(object,i,newitem);}}
+
+/* Create basic types: */
+cJSON *cJSON_CreateNull(void)                                  {cJSON *item=cJSON_New_Item();if(item)item->type=cJSON_NULL;return item;}
+cJSON *cJSON_CreateTrue(void)                                  {cJSON *item=cJSON_New_Item();if(item)item->type=cJSON_True;return item;}
+cJSON *cJSON_CreateFalse(void)                                 {cJSON *item=cJSON_New_Item();if(item)item->type=cJSON_False;return item;}
+cJSON *cJSON_CreateBool(int b)                                 {cJSON *item=cJSON_New_Item();if(item)item->type=b?cJSON_True:cJSON_False;return item;}
+cJSON *cJSON_CreateNumber(double num)                  {cJSON *item=cJSON_New_Item();if(item){item->type=cJSON_Number;item->valuedouble=num;item->valueint=(int)num;}return item;}
+cJSON *cJSON_CreateString(const char *string)  {cJSON *item=cJSON_New_Item();if(item){item->type=cJSON_String;item->valuestring=cJSON_strdup(string);}return item;}
+cJSON *cJSON_CreateArray(void)                                 {cJSON *item=cJSON_New_Item();if(item)item->type=cJSON_Array;return item;}
+cJSON *cJSON_CreateObject(void)                                        {cJSON *item=cJSON_New_Item();if(item)item->type=cJSON_Object;return item;}
+
+/* Create Arrays: */
+cJSON *cJSON_CreateIntArray(const int *numbers,int count)              {int i;cJSON *n=0,*p=0,*a=cJSON_CreateArray();for(i=0;a && i<count;i++){n=cJSON_CreateNumber(numbers[i]);if(!i)a->child=n;else suffix_object(p,n);p=n;}return a;}
+cJSON *cJSON_CreateFloatArray(const float *numbers,int count)  {int i;cJSON *n=0,*p=0,*a=cJSON_CreateArray();for(i=0;a && i<count;i++){n=cJSON_CreateNumber(numbers[i]);if(!i)a->child=n;else suffix_object(p,n);p=n;}return a;}
+cJSON *cJSON_CreateDoubleArray(const double *numbers,int count)        {int i;cJSON *n=0,*p=0,*a=cJSON_CreateArray();for(i=0;a && i<count;i++){n=cJSON_CreateNumber(numbers[i]);if(!i)a->child=n;else suffix_object(p,n);p=n;}return a;}
+cJSON *cJSON_CreateStringArray(const char **strings,int count) {int i;cJSON *n=0,*p=0,*a=cJSON_CreateArray();for(i=0;a && i<count;i++){n=cJSON_CreateString(strings[i]);if(!i)a->child=n;else suffix_object(p,n);p=n;}return a;}
+
+/* Duplication */
+cJSON *cJSON_Duplicate(cJSON *item,int recurse)
+{
+       cJSON *newitem,*cptr,*nptr=0,*newchild;
+       /* Bail on bad ptr */
+       if (!item) return 0;
+       /* Create new item */
+       newitem=cJSON_New_Item();
+       if (!newitem) return 0;
+       /* Copy over all vars */
+       newitem->type=item->type&(~cJSON_IsReference),newitem->valueint=item->valueint,newitem->valuedouble=item->valuedouble;
+       if (item->valuestring)  {newitem->valuestring=cJSON_strdup(item->valuestring);  if (!newitem->valuestring)      {cJSON_Delete(newitem);return 0;}}
+       if (item->string)               {newitem->string=cJSON_strdup(item->string);                    if (!newitem->string)           {cJSON_Delete(newitem);return 0;}}
+       /* If non-recursive, then we're done! */
+       if (!recurse) return newitem;
+       /* Walk the ->next chain for the child. */
+       cptr=item->child;
+       while (cptr)
+       {
+               newchild=cJSON_Duplicate(cptr,1);               /* Duplicate (with recurse) each item in the ->next chain */
+               if (!newchild) {cJSON_Delete(newitem);return 0;}
+               if (nptr)       {nptr->next=newchild,newchild->prev=nptr;nptr=newchild;}        /* If newitem->child already set, then crosswire ->prev and ->next and move on */
+               else            {newitem->child=newchild;nptr=newchild;}                                        /* Set newitem->child and move to it */
+               cptr=cptr->next;
+       }
+       return newitem;
+}
+
+void cJSON_Minify(char *json)
+{
+       char *into=json;
+       while (*json)
+       {
+               if (*json==' ') json++;
+               else if (*json=='\t') json++;   /* Whitespace characters. */
+               else if (*json=='\r') json++;
+               else if (*json=='\n') json++;
+               else if (*json=='/' && json[1]=='/')  while (*json && *json!='\n') json++;      /* double-slash comments, to end of line. */
+               else if (*json=='/' && json[1]=='*') {while (*json && !(*json=='*' && json[1]=='/')) json++;json+=2;}   /* multiline comments. */
+               else if (*json=='\"'){*into++=*json++;while (*json && *json!='\"'){if (*json=='\\') *into++=*json++;*into++=*json++;}*into++=*json++;} /* string literals, which are \" sensitive. */
+               else *into++=*json++;                   /* All other characters. */
+       }
+       *into=0;        /* and null-terminate. */
+}
diff --git a/components/json/port/cJSON_Utils.c b/components/json/port/cJSON_Utils.c
new file mode 100644 (file)
index 0000000..dd65c7c
--- /dev/null
@@ -0,0 +1,395 @@
+#include <ctype.h>
+#include <string.h>
+#include <stdlib.h>
+#include <stdio.h>
+#include "cJSON_Utils.h"
+
+static int cJSONUtils_strcasecmp(const char *s1,const char *s2)
+{
+       if (!s1) return (s1==s2)?0:1;if (!s2) return 1;
+       for(; tolower(*(const unsigned char *)s1) == tolower(*(const unsigned char *)s2); ++s1, ++s2)   if(*s1 == 0)    return 0;
+       return tolower(*(const unsigned char *)s1) - tolower(*(const unsigned char *)s2);
+}
+
+/* JSON Pointer implementation: */
+static int cJSONUtils_Pstrcasecmp(const char *a,const char *e)
+{
+       if (!a || !e) return (a==e)?0:1;
+       for (;*a && *e && *e!='/';a++,e++) {
+               if (*e=='~') {if (!(e[1]=='0' && *a=='~') && !(e[1]=='1' && *a=='/')) return 1;  else e++;}
+               else if (tolower(*(const unsigned char *)a)!=tolower(*(const unsigned char *)e)) return 1;
+       }
+       if ((*e!=0 && *e!='/') != (*a!=0)) return 1;
+       return 0;
+}
+
+static int cJSONUtils_PointerEncodedstrlen(const char *s)      {int l=0;for (;*s;s++,l++) if (*s=='~' || *s=='/') l++;return l;}
+
+static void cJSONUtils_PointerEncodedstrcpy(char *d,const char *s)
+{
+       for (;*s;s++)
+       {
+               if (*s=='/') {*d++='~';*d++='1';}
+               else if (*s=='~') {*d++='~';*d++='0';}
+               else *d++=*s;
+       }
+       *d=0;
+}
+
+char *cJSONUtils_FindPointerFromObjectTo(cJSON *object,cJSON *target)
+{
+       int type=object->type,c=0;cJSON *obj=0;
+
+       if (object==target) return strdup("");
+
+       for (obj=object->child;obj;obj=obj->next,c++)
+       {
+               char *found=cJSONUtils_FindPointerFromObjectTo(obj,target);
+               if (found)
+               {
+                       if (type==cJSON_Array)
+                       {
+                               char *ret=(char*)malloc(strlen(found)+23);
+                               sprintf(ret,"/%d%s",c,found);
+                               free(found);
+                               return ret;
+                       }
+                       else if (type==cJSON_Object)
+                       {
+                               char *ret=(char*)malloc(strlen(found)+cJSONUtils_PointerEncodedstrlen(obj->string)+2);
+                               *ret='/';cJSONUtils_PointerEncodedstrcpy(ret+1,obj->string);
+                               strcat(ret,found);
+                               free(found);
+                               return ret;
+                       }
+                       free(found);
+                       return 0;
+               }
+       }
+       return 0;
+}
+
+cJSON *cJSONUtils_GetPointer(cJSON *object,const char *pointer)
+{
+       while (*pointer++=='/' && object)
+       {
+               if (object->type==cJSON_Array)
+               {
+                       int which=0; while (*pointer>='0' && *pointer<='9') which=(10*which) + *pointer++ - '0';
+                       if (*pointer && *pointer!='/') return 0;
+                       object=cJSON_GetArrayItem(object,which);
+               }
+               else if (object->type==cJSON_Object)
+               {
+                       object=object->child;   while (object && cJSONUtils_Pstrcasecmp(object->string,pointer)) object=object->next;   /* GetObjectItem. */
+                       while (*pointer && *pointer!='/') pointer++;
+               }
+               else return 0;
+       }
+       return object;
+}
+
+/* JSON Patch implementation. */
+static void cJSONUtils_InplaceDecodePointerString(char *string)
+{
+       char *s2=string;
+       for (;*string;s2++,string++) *s2=(*string!='~')?(*string):((*(++string)=='0')?'~':'/');
+       *s2=0;
+}
+
+static cJSON *cJSONUtils_PatchDetach(cJSON *object,const char *path)
+{
+       char *parentptr=0,*childptr=0;cJSON *parent=0,*ret=0;
+
+       parentptr=strdup(path); childptr=strrchr(parentptr,'/');        if (childptr) *childptr++=0;
+       parent=cJSONUtils_GetPointer(object,parentptr);
+       cJSONUtils_InplaceDecodePointerString(childptr);
+
+       if (!parent) ret=0;     /* Couldn't find object to remove child from. */
+       else if (parent->type==cJSON_Array)             ret=cJSON_DetachItemFromArray(parent,atoi(childptr));
+       else if (parent->type==cJSON_Object)    ret=cJSON_DetachItemFromObject(parent,childptr);
+       free(parentptr);
+       return ret;
+}
+
+static int cJSONUtils_Compare(cJSON *a,cJSON *b)
+{
+       if (a->type!=b->type)   return -1;      /* mismatched type. */
+       switch (a->type)
+       {
+       case cJSON_Number:      return (a->valueint!=b->valueint || a->valuedouble!=b->valuedouble)?-2:0;       /* numeric mismatch. */
+       case cJSON_String:      return (strcmp(a->valuestring,b->valuestring)!=0)?-3:0;                                         /* string mismatch. */
+       case cJSON_Array:       for (a=a->child,b=b->child;a && b;a=a->next,b=b->next)  {int err=cJSONUtils_Compare(a,b);if (err) return err;}
+                                               return (a || b)?-4:0;   /* array size mismatch. */
+       case cJSON_Object:
+                                               cJSONUtils_SortObject(a);
+                                               cJSONUtils_SortObject(b);
+                                               a=a->child,b=b->child;
+                                               while (a && b)
+                                               {
+                                                       int err;
+                                                       if (cJSONUtils_strcasecmp(a->string,b->string)) return -6;      /* missing member */
+                                                       err=cJSONUtils_Compare(a,b);if (err) return err;
+                                                       a=a->next,b=b->next;
+                                               }
+                                               return (a || b)?-5:0;   /* object length mismatch */
+
+       default:                        break;
+       }
+       return 0;
+}
+
+static int cJSONUtils_ApplyPatch(cJSON *object,cJSON *patch)
+{
+       cJSON *op=0,*path=0,*value=0,*parent=0;int opcode=0;char *parentptr=0,*childptr=0;
+
+       op=cJSON_GetObjectItem(patch,"op");
+       path=cJSON_GetObjectItem(patch,"path");
+       if (!op || !path) return 2;     /* malformed patch. */
+
+       if              (!strcmp(op->valuestring,"add"))        opcode=0;
+       else if (!strcmp(op->valuestring,"remove")) opcode=1;
+       else if (!strcmp(op->valuestring,"replace"))opcode=2;
+       else if (!strcmp(op->valuestring,"move"))       opcode=3;
+       else if (!strcmp(op->valuestring,"copy"))       opcode=4;
+       else if (!strcmp(op->valuestring,"test"))       return cJSONUtils_Compare(cJSONUtils_GetPointer(object,path->valuestring),cJSON_GetObjectItem(patch,"value"));
+       else return 3; /* unknown opcode. */
+
+       if (opcode==1 || opcode==2)     /* Remove/Replace */
+       {
+               cJSON_Delete(cJSONUtils_PatchDetach(object,path->valuestring)); /* Get rid of old. */
+               if (opcode==1) return 0;        /* For Remove, this is job done. */
+       }
+
+       if (opcode==3 || opcode==4)     /* Copy/Move uses "from". */
+       {
+               cJSON *from=cJSON_GetObjectItem(patch,"from");  if (!from) return 4; /* missing "from" for copy/move. */
+
+               if (opcode==3) value=cJSONUtils_PatchDetach(object,from->valuestring);
+               if (opcode==4) value=cJSONUtils_GetPointer(object,from->valuestring);
+               if (!value) return 5; /* missing "from" for copy/move. */
+               if (opcode==4) value=cJSON_Duplicate(value,1);
+               if (!value) return 6; /* out of memory for copy/move. */
+       }
+       else    /* Add/Replace uses "value". */
+       {
+               value=cJSON_GetObjectItem(patch,"value");
+               if (!value) return 7; /* missing "value" for add/replace. */
+               value=cJSON_Duplicate(value,1);
+               if (!value) return 8; /* out of memory for add/replace. */
+       }
+               
+       /* Now, just add "value" to "path". */
+
+       parentptr=strdup(path->valuestring);    childptr=strrchr(parentptr,'/');        if (childptr) *childptr++=0;
+       parent=cJSONUtils_GetPointer(object,parentptr);
+       cJSONUtils_InplaceDecodePointerString(childptr);
+
+       /* add, remove, replace, move, copy, test. */
+       if (!parent) {free(parentptr); cJSON_Delete(value); return 9;}  /* Couldn't find object to add to. */
+       else if (parent->type==cJSON_Array)
+       {
+               if (!strcmp(childptr,"-"))      cJSON_AddItemToArray(parent,value);
+               else                                            cJSON_InsertItemInArray(parent,atoi(childptr),value);
+       }
+       else if (parent->type==cJSON_Object)
+       {
+               cJSON_DeleteItemFromObject(parent,childptr);
+               cJSON_AddItemToObject(parent,childptr,value);
+       }
+       else
+       {
+               cJSON_Delete(value);
+       }
+       free(parentptr);
+       return 0;
+}
+
+
+int cJSONUtils_ApplyPatches(cJSON *object,cJSON *patches)
+{
+       int err;
+       if (patches->type!=cJSON_Array) return 1;       /* malformed patches. */
+       if (patches) patches=patches->child;
+       while (patches)
+       {
+               if ((err=cJSONUtils_ApplyPatch(object,patches))) return err;
+               patches=patches->next;
+       }
+       return 0;
+}
+
+static void cJSONUtils_GeneratePatch(cJSON *patches,const char *op,const char *path,const char *suffix,cJSON *val)
+{
+       cJSON *patch=cJSON_CreateObject();
+       cJSON_AddItemToObject(patch,"op",cJSON_CreateString(op));
+       if (suffix)
+       {
+               char *newpath=(char*)malloc(strlen(path)+cJSONUtils_PointerEncodedstrlen(suffix)+2);
+               cJSONUtils_PointerEncodedstrcpy(newpath+sprintf(newpath,"%s/",path),suffix);
+               cJSON_AddItemToObject(patch,"path",cJSON_CreateString(newpath));
+               free(newpath);
+       }
+       else    cJSON_AddItemToObject(patch,"path",cJSON_CreateString(path));
+       if (val) cJSON_AddItemToObject(patch,"value",cJSON_Duplicate(val,1));
+       cJSON_AddItemToArray(patches,patch);
+}
+
+void cJSONUtils_AddPatchToArray(cJSON *array,const char *op,const char *path,cJSON *val)       {cJSONUtils_GeneratePatch(array,op,path,0,val);}
+
+static void cJSONUtils_CompareToPatch(cJSON *patches,const char *path,cJSON *from,cJSON *to)
+{
+       if (from->type!=to->type)       {cJSONUtils_GeneratePatch(patches,"replace",path,0,to); return; }
+       
+       switch (from->type)
+       {
+       case cJSON_Number:      
+               if (from->valueint!=to->valueint || from->valuedouble!=to->valuedouble)
+                       cJSONUtils_GeneratePatch(patches,"replace",path,0,to);
+               return;
+                                               
+       case cJSON_String:      
+               if (strcmp(from->valuestring,to->valuestring)!=0)
+                       cJSONUtils_GeneratePatch(patches,"replace",path,0,to);
+               return;
+
+       case cJSON_Array:
+       {
+               int c;char *newpath=(char*)malloc(strlen(path)+23);     /* Allow space for 64bit int. */
+               for (c=0,from=from->child,to=to->child;from && to;from=from->next,to=to->next,c++){
+                                                                               sprintf(newpath,"%s/%d",path,c);        cJSONUtils_CompareToPatch(patches,newpath,from,to);
+               }
+               for (;from;from=from->next,c++) {sprintf(newpath,"%d",c);       cJSONUtils_GeneratePatch(patches,"remove",path,newpath,0);      }
+               for (;to;to=to->next,c++)               cJSONUtils_GeneratePatch(patches,"add",path,"-",to);
+               free(newpath);
+               return;
+       }
+
+       case cJSON_Object:
+       {
+               cJSON *a,*b;
+               cJSONUtils_SortObject(from);
+               cJSONUtils_SortObject(to);
+               
+               a=from->child,b=to->child;
+               while (a || b)
+               {
+                       int diff=(!a)?1:(!b)?-1:cJSONUtils_strcasecmp(a->string,b->string);
+                       if (!diff)
+                       {
+                               char *newpath=(char*)malloc(strlen(path)+cJSONUtils_PointerEncodedstrlen(a->string)+2);
+                               cJSONUtils_PointerEncodedstrcpy(newpath+sprintf(newpath,"%s/",path),a->string);
+                               cJSONUtils_CompareToPatch(patches,newpath,a,b);
+                               free(newpath);
+                               a=a->next;
+                               b=b->next;
+                       }
+                       else if (diff<0)        {cJSONUtils_GeneratePatch(patches,"remove",path,a->string,0);   a=a->next;}
+                       else                            {cJSONUtils_GeneratePatch(patches,"add",path,b->string,b);              b=b->next;}
+               }
+               return;
+       }
+
+       default:                        break;
+       }
+}
+
+
+cJSON* cJSONUtils_GeneratePatches(cJSON *from,cJSON *to)
+{
+       cJSON *patches=cJSON_CreateArray();     
+       cJSONUtils_CompareToPatch(patches,"",from,to);
+       return patches;
+}
+
+
+static cJSON *cJSONUtils_SortList(cJSON *list)
+{
+       cJSON *first=list,*second=list,*ptr=list;
+
+       if (!list || !list->next) return list;  /* One entry is sorted already. */
+       
+       while (ptr && ptr->next && cJSONUtils_strcasecmp(ptr->string,ptr->next->string)<0) ptr=ptr->next;       /* Test for list sorted. */
+       if (!ptr || !ptr->next) return list;    /* Leave sorted lists unmodified. */
+       ptr=list;
+
+       while (ptr) {second=second->next;ptr=ptr->next;if (ptr) ptr=ptr->next;} /* Walk two pointers to find the middle. */
+       if (second && second->prev) second->prev->next=0;       /* Split the lists */
+
+       first=cJSONUtils_SortList(first);       /* Recursively sort the sub-lists. */
+       second=cJSONUtils_SortList(second);
+       list=ptr=0;
+
+       while (first && second) /* Merge the sub-lists */
+       {               
+               if (cJSONUtils_strcasecmp(first->string,second->string)<0)
+               {
+                       if (!list) list=ptr=first;
+                       else    {ptr->next=first;first->prev=ptr;ptr=first;}
+                       first=first->next;
+               }
+               else 
+               {
+                       if (!list) list=ptr=second;
+                       else    {ptr->next=second;second->prev=ptr;ptr=second;}
+                       second=second->next;
+               }
+       }
+       if (first)      {       if (!list) return first;        ptr->next=first;        first->prev=ptr;        }       /* Append any tails. */
+       if (second)     {       if (!list) return second;       ptr->next=second;       second->prev=ptr;       }
+
+       return list;
+}
+
+void cJSONUtils_SortObject(cJSON *object)      {object->child=cJSONUtils_SortList(object->child);}
+
+cJSON* cJSONUtils_MergePatch(cJSON *target, cJSON *patch)
+{
+       if (!patch || patch->type != cJSON_Object) {cJSON_Delete(target);return cJSON_Duplicate(patch,1);}
+       if (!target || target->type != cJSON_Object) {cJSON_Delete(target);target=cJSON_CreateObject();}
+
+       patch=patch->child;
+       while (patch)
+       {
+               if (patch->type == cJSON_NULL) cJSON_DeleteItemFromObject(target,patch->string);
+               else
+               {
+                       cJSON *replaceme=cJSON_DetachItemFromObject(target,patch->string);
+                       cJSON_AddItemToObject(target,patch->string,cJSONUtils_MergePatch(replaceme,patch));
+               }
+               patch=patch->next;
+       }
+       return target;
+}
+
+cJSON *cJSONUtils_GenerateMergePatch(cJSON *from,cJSON *to)
+{
+       cJSON *patch=0;
+       if (!to) return cJSON_CreateNull();
+       if (to->type!=cJSON_Object || !from || from->type!=cJSON_Object) return cJSON_Duplicate(to,1);
+       cJSONUtils_SortObject(from);
+       cJSONUtils_SortObject(to);
+       from=from->child;to=to->child;
+       patch=cJSON_CreateObject();
+       while (from || to)
+       {
+               int compare=from?(to?strcmp(from->string,to->string):-1):1;
+               if (compare<0)
+               {
+                       cJSON_AddItemToObject(patch,from->string,cJSON_CreateNull());
+                       from=from->next;
+               }
+               else if (compare>0)
+               {
+                       cJSON_AddItemToObject(patch,to->string,cJSON_Duplicate(to,1));
+                       to=to->next;
+               }
+               else
+               {
+                       if (cJSONUtils_Compare(from,to)) cJSON_AddItemToObject(patch,to->string,cJSONUtils_GenerateMergePatch(from,to));
+                       from=from->next;to=to->next;
+               }
+       }
+       if (!patch->child) {cJSON_Delete(patch);return 0;}
+       return patch;
+}
\ No newline at end of file
diff --git a/components/json/port/include/cJSON_Utils.h b/components/json/port/include/cJSON_Utils.h
new file mode 100644 (file)
index 0000000..b129b06
--- /dev/null
@@ -0,0 +1,30 @@
+#include "cJSON.h"
+
+/* Implement RFC6901 (https://tools.ietf.org/html/rfc6901) JSON Pointer spec.  */
+cJSON *cJSONUtils_GetPointer(cJSON *object,const char *pointer);
+
+/* Implement RFC6902 (https://tools.ietf.org/html/rfc6902) JSON Patch spec.            */
+cJSON* cJSONUtils_GeneratePatches(cJSON *from,cJSON *to);
+void cJSONUtils_AddPatchToArray(cJSON *array,const char *op,const char *path,cJSON *val);      /* Utility for generating patch array entries.  */
+int cJSONUtils_ApplyPatches(cJSON *object,cJSON *patches);     /* Returns 0 for success. */
+
+/*
+// Note that ApplyPatches is NOT atomic on failure. To implement an atomic ApplyPatches, use:
+//int cJSONUtils_AtomicApplyPatches(cJSON **object, cJSON *patches)
+//{
+//     cJSON *modme=cJSON_Duplicate(*object,1);
+//     int error=cJSONUtils_ApplyPatches(modme,patches);
+//     if (!error)     {cJSON_Delete(*object);*object=modme;}
+//     else            cJSON_Delete(modme);
+//     return error;
+//}
+// Code not added to library since this strategy is a LOT slower.
+*/
+
+/* Implement RFC7386 (https://tools.ietf.org/html/rfc7396) JSON Merge Patch spec. */
+cJSON* cJSONUtils_MergePatch(cJSON *target, cJSON *patch); /* target will be modified by patch. return value is new ptr for target. */
+cJSON *cJSONUtils_GenerateMergePatch(cJSON *from,cJSON *to); /* generates a patch to move from -> to */
+
+char *cJSONUtils_FindPointerFromObjectTo(cJSON *object,cJSON *target); /* Given a root object and a target object, construct a pointer from one to the other.  */
+
+void cJSONUtils_SortObject(cJSON *object);     /* Sorts the members of the object into alphabetical order.     */