Actual source code: cJSON.c
1: /*
2: Copyright (c) 2009-2017 Dave Gamble and cJSON contributors
4: Permission is hereby granted, free of charge, to any person obtaining a copy
5: of this software and associated documentation files (the "Software"), to deal
6: in the Software without restriction, including without limitation the rights
7: to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
8: copies of the Software, and to permit persons to whom the Software is
9: furnished to do so, subject to the following conditions:
11: The above copyright notice and this permission notice shall be included in
12: all copies or substantial portions of the Software.
14: THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
15: IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16: FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
17: AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
18: LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
19: OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
20: THE SOFTWARE.
21: */
23: /* cJSON */
24: /* JSON parser in C. */
26: /* disable warnings about old C89 functions in MSVC */
27: #if !defined(_CRT_SECURE_NO_DEPRECATE) && defined(_MSC_VER)
28: #define _CRT_SECURE_NO_DEPRECATE
29: #endif
31: #ifdef __GNUC__
32: #pragma GCC visibility push(default)
33: #endif
34: #if defined(_MSC_VER)
35: #pragma warning(push)
36: /* disable warning about single line comments in system headers */
37: #pragma warning(disable : 4001)
38: #endif
40: #include <string.h>
41: #include <stdio.h>
42: #include <math.h>
43: #include <stdlib.h>
44: #include <limits.h>
45: #include <ctype.h>
46: #include <float.h>
48: #ifdef ENABLE_LOCALES
49: #include <locale.h>
50: #endif
52: #if defined(_MSC_VER)
53: #pragma warning(pop)
54: #endif
55: #ifdef __GNUC__
56: #pragma GCC visibility pop
57: #endif
59: #include "cJSON.h"
61: /* define our own boolean type */
62: #ifdef true
63: #undef true
64: #endif
65: #define true ((cJSON_bool)1)
67: #ifdef false
68: #undef false
69: #endif
70: #define false ((cJSON_bool)0)
72: /* define isnan and isinf for ANSI C, if in C99 or above, isnan and isinf has been defined in math.h */
73: #ifndef isinf
74: #define isinf(d) (isnan((d - d)) && !isnan(d))
75: #endif
76: #ifndef isnan
77: #define isnan(d) (d != d)
78: #endif
80: #ifndef NAN
81: #ifdef _WIN32
82: #define NAN sqrt(-1.0)
83: #else
84: #define NAN 0.0 / 0.0
85: #endif
86: #endif
88: typedef struct {
89: const unsigned char *json;
90: size_t position;
91: } error;
92: static error global_error = {NULL, 0};
94: CJSON_PUBLIC(const char *) cJSON_GetErrorPtr(void)
95: {
96: return (const char *)(global_error.json + global_error.position);
97: }
99: CJSON_PUBLIC(char *) cJSON_GetStringValue(const cJSON *const item)
100: {
101: if (!cJSON_IsString(item)) { return NULL; }
103: return item->valuestring;
104: }
106: CJSON_PUBLIC(double) cJSON_GetNumberValue(const cJSON *const item)
107: {
108: if (!cJSON_IsNumber(item)) { return (double)NAN; }
110: return item->valuedouble;
111: }
113: /* This is a safeguard to prevent copy-pasters from using incompatible C and header files */
114: #if (CJSON_VERSION_MAJOR != 1) || (CJSON_VERSION_MINOR != 7) || (CJSON_VERSION_PATCH != 15)
115: #error cJSON.h and cJSON.c have different versions. Make sure that both have the same.
116: #endif
118: CJSON_PUBLIC(const char *) cJSON_Version(void)
119: {
120: static char version[15];
121: snprintf(version, sizeof(version) / sizeof(version[0]), "%i.%i.%i", CJSON_VERSION_MAJOR, CJSON_VERSION_MINOR, CJSON_VERSION_PATCH);
123: return version;
124: }
126: /* Case insensitive string comparison, doesn't consider two NULL pointers equal though */
127: static int case_insensitive_strcmp(const unsigned char *string1, const unsigned char *string2)
128: {
129: if ((string1 == NULL) || (string2 == NULL)) { return 1; }
131: if (string1 == string2) { return 0; }
133: for (; tolower(*string1) == tolower(*string2); (void)string1++, string2++) {
134: if (*string1 == '\0') { return 0; }
135: }
137: return tolower(*string1) - tolower(*string2);
138: }
140: typedef struct internal_hooks {
141: void *(CJSON_CDECL *allocate)(size_t size);
142: void(CJSON_CDECL *deallocate)(void *pointer);
143: void *(CJSON_CDECL *reallocate)(void *pointer, size_t size);
144: } internal_hooks;
146: #if defined(_MSC_VER)
147: /* work around MSVC error C2322: '...' address of dllimport '...' is not static */
148: static void *CJSON_CDECL internal_malloc(size_t size)
149: {
150: return malloc(size);
151: }
152: static void CJSON_CDECL internal_free(void *pointer)
153: {
154: free(pointer);
155: }
156: static void *CJSON_CDECL internal_realloc(void *pointer, size_t size)
157: {
158: return realloc(pointer, size);
159: }
160: #else
161: #define internal_malloc malloc
162: #define internal_free free
163: #define internal_realloc realloc
164: #endif
166: /* strlen of character literals resolved at compile time */
167: #define static_strlen(string_literal) (sizeof(string_literal) - sizeof(""))
169: static internal_hooks global_hooks = {internal_malloc, internal_free, internal_realloc};
171: static unsigned char *cJSON_strdup(const unsigned char *string, const internal_hooks *const hooks)
172: {
173: size_t length = 0;
174: unsigned char *copy = NULL;
176: if (string == NULL) { return NULL; }
178: length = strlen((const char *)string) + sizeof("");
179: copy = (unsigned char *)hooks->allocate(length);
180: if (copy == NULL) { return NULL; }
181: memcpy(copy, string, length);
183: return copy;
184: }
186: CJSON_PUBLIC(void) cJSON_InitHooks(cJSON_Hooks *hooks)
187: {
188: if (hooks == NULL) {
189: /* Reset hooks */
190: global_hooks.allocate = malloc;
191: global_hooks.deallocate = free;
192: global_hooks.reallocate = realloc;
193: return;
194: }
196: global_hooks.allocate = malloc;
197: if (hooks->malloc_fn != NULL) { global_hooks.allocate = hooks->malloc_fn; }
199: global_hooks.deallocate = free;
200: if (hooks->free_fn != NULL) { global_hooks.deallocate = hooks->free_fn; }
202: /* use realloc only if both free and malloc are used */
203: global_hooks.reallocate = NULL;
204: if ((global_hooks.allocate == malloc) && (global_hooks.deallocate == free)) { global_hooks.reallocate = realloc; }
205: }
207: /* Internal constructor. */
208: static cJSON *cJSON_New_Item(const internal_hooks *const hooks)
209: {
210: cJSON *node = (cJSON *)hooks->allocate(sizeof(cJSON));
211: if (node) { memset(node, '\0', sizeof(cJSON)); }
213: return node;
214: }
216: /* Delete a cJSON structure. */
217: CJSON_PUBLIC(void) cJSON_Delete(cJSON *item)
218: {
219: cJSON *next = NULL;
220: while (item != NULL) {
221: next = item->next;
222: if (!(item->type & cJSON_IsReference) && (item->child != NULL)) { cJSON_Delete(item->child); }
223: if (!(item->type & cJSON_IsReference) && (item->valuestring != NULL)) { global_hooks.deallocate(item->valuestring); }
224: if (!(item->type & cJSON_StringIsConst) && (item->string != NULL)) { global_hooks.deallocate(item->string); }
225: global_hooks.deallocate(item);
226: item = next;
227: }
228: }
230: /* get the decimal point character of the current locale */
231: static unsigned char get_decimal_point(void)
232: {
233: #ifdef ENABLE_LOCALES
234: struct lconv *lconv = localeconv();
235: return (unsigned char)lconv->decimal_point[0];
236: #else
237: return '.';
238: #endif
239: }
241: typedef struct {
242: const unsigned char *content;
243: size_t length;
244: size_t offset;
245: size_t depth; /* How deeply nested (in arrays/objects) is the input at the current offset. */
246: internal_hooks hooks;
247: } parse_buffer;
249: /* check if the given size is left to read in a given parse buffer (starting with 1) */
250: #define can_read(buffer, size) ((buffer != NULL) && (((buffer)->offset + size) <= (buffer)->length))
251: /* check if the buffer can be accessed at the given index (starting with 0) */
252: #define can_access_at_index(buffer, index) ((buffer != NULL) && (((buffer)->offset + index) < (buffer)->length))
253: #define cannot_access_at_index(buffer, index) (!can_access_at_index(buffer, index))
254: /* get a pointer to the buffer at the position */
255: #define buffer_at_offset(buffer) ((buffer)->content + (buffer)->offset)
257: /* Parse the input text to generate a number, and populate the result into item. */
258: static cJSON_bool parse_number(cJSON *const item, parse_buffer *const input_buffer)
259: {
260: double number = 0;
261: unsigned char *after_end = NULL;
262: unsigned char number_c_string[64];
263: unsigned char decimal_point = get_decimal_point();
264: size_t i = 0;
266: if ((input_buffer == NULL) || (input_buffer->content == NULL)) { return false; }
268: /* copy the number into a temporary buffer and replace '.' with the decimal point
269: * of the current locale (for strtod)
270: * This also takes care of '\0' not necessarily being available for marking the end of the input */
271: for (i = 0; (i < (sizeof(number_c_string) - 1)) && can_access_at_index(input_buffer, i); i++) {
272: switch (buffer_at_offset(input_buffer)[i]) {
273: case '0':
274: case '1':
275: case '2':
276: case '3':
277: case '4':
278: case '5':
279: case '6':
280: case '7':
281: case '8':
282: case '9':
283: case '+':
284: case '-':
285: case 'e':
286: case 'E':
287: number_c_string[i] = buffer_at_offset(input_buffer)[i];
288: break;
290: case '.':
291: number_c_string[i] = decimal_point;
292: break;
294: default:
295: goto loop_end;
296: }
297: }
298: loop_end:
299: number_c_string[i] = '\0';
301: number = strtod((const char *)number_c_string, (char **)&after_end);
302: if (number_c_string == after_end) { return false; /* parse_error */ }
304: item->valuedouble = number;
306: /* use saturation in case of overflow */
307: if (number >= INT_MAX) {
308: item->valueint = INT_MAX;
309: } else if (number <= (double)INT_MIN) {
310: item->valueint = INT_MIN;
311: } else {
312: item->valueint = (int)number;
313: }
315: item->type = cJSON_Number;
317: input_buffer->offset += (size_t)(after_end - number_c_string);
318: return true;
319: }
321: /* don't ask me, but the original cJSON_SetNumberValue returns an integer or double */
322: CJSON_PUBLIC(double) cJSON_SetNumberHelper(cJSON *object, double number)
323: {
324: if (number >= INT_MAX) {
325: object->valueint = INT_MAX;
326: } else if (number <= (double)INT_MIN) {
327: object->valueint = INT_MIN;
328: } else {
329: object->valueint = (int)number;
330: }
332: return object->valuedouble = number;
333: }
335: CJSON_PUBLIC(char *) cJSON_SetValuestring(cJSON *object, const char *valuestring)
336: {
337: char *copy = NULL;
338: /* if object's type is not cJSON_String or is cJSON_IsReference, it should not set valuestring */
339: if (!(object->type & cJSON_String) || (object->type & cJSON_IsReference)) { return NULL; }
340: if (strlen(valuestring) <= strlen(object->valuestring)) {
341: strcpy(object->valuestring, valuestring);
342: return object->valuestring;
343: }
344: copy = (char *)cJSON_strdup((const unsigned char *)valuestring, &global_hooks);
345: if (copy == NULL) { return NULL; }
346: if (object->valuestring != NULL) { cJSON_free(object->valuestring); }
347: object->valuestring = copy;
349: return copy;
350: }
352: typedef struct {
353: unsigned char *buffer;
354: size_t length;
355: size_t offset;
356: size_t depth; /* current nesting depth (for formatted printing) */
357: cJSON_bool noalloc;
358: cJSON_bool format; /* is this print a formatted print */
359: internal_hooks hooks;
360: } printbuffer;
362: /* realloc printbuffer if necessary to have at least "needed" bytes more */
363: static unsigned char *ensure(printbuffer *const p, size_t needed)
364: {
365: unsigned char *newbuffer = NULL;
366: size_t newsize = 0;
368: if ((p == NULL) || (p->buffer == NULL)) { return NULL; }
370: if ((p->length > 0) && (p->offset >= p->length)) {
371: /* make sure that offset is valid */
372: return NULL;
373: }
375: if (needed > INT_MAX) {
376: /* sizes bigger than INT_MAX are currently not supported */
377: return NULL;
378: }
380: needed += p->offset + 1;
381: if (needed <= p->length) { return p->buffer + p->offset; }
383: if (p->noalloc) { return NULL; }
385: /* calculate new buffer size */
386: if (needed > (INT_MAX / 2)) {
387: /* overflow of int, use INT_MAX if possible */
388: if (needed <= INT_MAX) {
389: newsize = INT_MAX;
390: } else {
391: return NULL;
392: }
393: } else {
394: newsize = needed * 2;
395: }
397: if (p->hooks.reallocate != NULL) {
398: /* reallocate with realloc if available */
399: newbuffer = (unsigned char *)p->hooks.reallocate(p->buffer, newsize);
400: if (newbuffer == NULL) {
401: p->hooks.deallocate(p->buffer);
402: p->length = 0;
403: p->buffer = NULL;
405: return NULL;
406: }
407: } else {
408: /* otherwise reallocate manually */
409: newbuffer = (unsigned char *)p->hooks.allocate(newsize);
410: if (!newbuffer) {
411: p->hooks.deallocate(p->buffer);
412: p->length = 0;
413: p->buffer = NULL;
415: return NULL;
416: }
418: memcpy(newbuffer, p->buffer, p->offset + 1);
419: p->hooks.deallocate(p->buffer);
420: }
421: p->length = newsize;
422: p->buffer = newbuffer;
424: return newbuffer + p->offset;
425: }
427: /* calculate the new length of the string in a printbuffer and update the offset */
428: static void update_offset(printbuffer *const buffer)
429: {
430: const unsigned char *buffer_pointer = NULL;
431: if ((buffer == NULL) || (buffer->buffer == NULL)) { return; }
432: buffer_pointer = buffer->buffer + buffer->offset;
434: buffer->offset += strlen((const char *)buffer_pointer);
435: }
437: /* securely comparison of floating-point variables */
438: static cJSON_bool compare_double(double a, double b)
439: {
440: double maxVal = fabs(a) > fabs(b) ? fabs(a) : fabs(b);
441: return (fabs(a - b) <= maxVal * DBL_EPSILON);
442: }
444: /* Render the number nicely from the given item into a string. */
445: static cJSON_bool print_number(const cJSON *const item, printbuffer *const output_buffer)
446: {
447: unsigned char *output_pointer = NULL;
448: double d = item->valuedouble;
449: int length = 0;
450: size_t i = 0;
451: unsigned char number_buffer[26] = {0}; /* temporary buffer to print the number into */
452: unsigned char decimal_point = get_decimal_point();
453: double test = 0.0;
455: if (output_buffer == NULL) { return false; }
457: /* This checks for NaN and Infinity */
458: if (isnan(d) || isinf(d)) {
459: length = snprintf((char *)number_buffer, sizeof(number_buffer) / sizeof(number_buffer[0]), "null");
460: } else if (d == (double)item->valueint) {
461: length = snprintf((char *)number_buffer, sizeof(number_buffer) / sizeof(number_buffer[0]), "%d", item->valueint);
462: } else {
463: /* Try 15 decimal places of precision to avoid nonsignificant nonzero digits */
464: length = snprintf((char *)number_buffer, sizeof(number_buffer) / sizeof(number_buffer[0]), "%1.15g", d);
466: /* Check whether the original double can be recovered */
467: if ((sscanf((char *)number_buffer, "%lg", &test) != 1) || !compare_double((double)test, d)) {
468: /* If not, print with 17 decimal places of precision */
469: length = snprintf((char *)number_buffer, sizeof(number_buffer) / sizeof(number_buffer[0]), "%1.17g", d);
470: }
471: }
473: /* snprintf failed or buffer overrun occurred */
474: if ((length < 0) || (length > (int)(sizeof(number_buffer) - 1))) { return false; }
476: /* reserve appropriate space in the output */
477: output_pointer = ensure(output_buffer, (size_t)length + sizeof(""));
478: if (output_pointer == NULL) { return false; }
480: /* copy the printed number to the output and replace locale
481: * dependent decimal point with '.' */
482: for (i = 0; i < ((size_t)length); i++) {
483: if (number_buffer[i] == decimal_point) {
484: output_pointer[i] = '.';
485: continue;
486: }
488: output_pointer[i] = number_buffer[i];
489: }
490: output_pointer[i] = '\0';
492: output_buffer->offset += (size_t)length;
494: return true;
495: }
497: /* parse 4 digit hexadecimal number */
498: static unsigned parse_hex4(const unsigned char *const input)
499: {
500: unsigned int h = 0;
501: size_t i = 0;
503: for (i = 0; i < 4; i++) {
504: /* parse digit */
505: if ((input[i] >= '0') && (input[i] <= '9')) {
506: h += (unsigned int)input[i] - '0';
507: } else if ((input[i] >= 'A') && (input[i] <= 'F')) {
508: h += (unsigned int)10 + input[i] - 'A';
509: } else if ((input[i] >= 'a') && (input[i] <= 'f')) {
510: h += (unsigned int)10 + input[i] - 'a';
511: } else /* invalid */
512: {
513: return 0;
514: }
516: if (i < 3) {
517: /* shift left to make place for the next nibble */
518: h = h << 4;
519: }
520: }
522: return h;
523: }
525: /* converts a UTF-16 literal to UTF-8
526: * A literal can be one or two sequences of the form \uXXXX */
527: static unsigned char utf16_literal_to_utf8(const unsigned char *const input_pointer, const unsigned char *const input_end, unsigned char **output_pointer)
528: {
529: long unsigned int codepoint = 0;
530: unsigned int first_code = 0;
531: const unsigned char *first_sequence = input_pointer;
532: unsigned char utf8_length = 0;
533: unsigned char utf8_position = 0;
534: unsigned char sequence_length = 0;
535: unsigned char first_byte_mark = 0;
537: if ((input_end - first_sequence) < 6) {
538: /* input ends unexpectedly */
539: goto fail;
540: }
542: /* get the first utf16 sequence */
543: first_code = parse_hex4(first_sequence + 2);
545: /* check that the code is valid */
546: if (((first_code >= 0xDC00) && (first_code <= 0xDFFF))) { goto fail; }
548: /* UTF16 surrogate pair */
549: if ((first_code >= 0xD800) && (first_code <= 0xDBFF)) {
550: const unsigned char *second_sequence = first_sequence + 6;
551: unsigned int second_code = 0;
552: sequence_length = 12; /* \uXXXX\uXXXX */
554: if ((input_end - second_sequence) < 6) {
555: /* input ends unexpectedly */
556: goto fail;
557: }
559: if ((second_sequence[0] != '\\') || (second_sequence[1] != 'u')) {
560: /* missing second half of the surrogate pair */
561: goto fail;
562: }
564: /* get the second utf16 sequence */
565: second_code = parse_hex4(second_sequence + 2);
566: /* check that the code is valid */
567: if ((second_code < 0xDC00) || (second_code > 0xDFFF)) {
568: /* invalid second half of the surrogate pair */
569: goto fail;
570: }
572: /* calculate the unicode codepoint from the surrogate pair */
573: codepoint = 0x10000 + (((first_code & 0x3FF) << 10) | (second_code & 0x3FF));
574: } else {
575: sequence_length = 6; /* \uXXXX */
576: codepoint = first_code;
577: }
579: /* encode as UTF-8
580: * takes at maximum 4 bytes to encode:
581: * 11110xxx 10xxxxxx 10xxxxxx 10xxxxxx */
582: if (codepoint < 0x80) {
583: /* normal ascii, encoding 0xxxxxxx */
584: utf8_length = 1;
585: } else if (codepoint < 0x800) {
586: /* two bytes, encoding 110xxxxx 10xxxxxx */
587: utf8_length = 2;
588: first_byte_mark = 0xC0; /* 11000000 */
589: } else if (codepoint < 0x10000) {
590: /* three bytes, encoding 1110xxxx 10xxxxxx 10xxxxxx */
591: utf8_length = 3;
592: first_byte_mark = 0xE0; /* 11100000 */
593: } else if (codepoint <= 0x10FFFF) {
594: /* four bytes, encoding 1110xxxx 10xxxxxx 10xxxxxx 10xxxxxx */
595: utf8_length = 4;
596: first_byte_mark = 0xF0; /* 11110000 */
597: } else {
598: /* invalid unicode codepoint */
599: goto fail;
600: }
602: /* encode as utf8 */
603: for (utf8_position = (unsigned char)(utf8_length - 1); utf8_position > 0; utf8_position--) {
604: /* 10xxxxxx */
605: (*output_pointer)[utf8_position] = (unsigned char)((codepoint | 0x80) & 0xBF);
606: codepoint >>= 6;
607: }
608: /* encode first byte */
609: if (utf8_length > 1) {
610: (*output_pointer)[0] = (unsigned char)((codepoint | first_byte_mark) & 0xFF);
611: } else {
612: (*output_pointer)[0] = (unsigned char)(codepoint & 0x7F);
613: }
615: *output_pointer += utf8_length;
617: return sequence_length;
619: fail:
620: return 0;
621: }
623: /* Parse the input text into an unescaped cinput, and populate item. */
624: static cJSON_bool parse_string(cJSON *const item, parse_buffer *const input_buffer)
625: {
626: const unsigned char *input_pointer = buffer_at_offset(input_buffer) + 1;
627: const unsigned char *input_end = buffer_at_offset(input_buffer) + 1;
628: unsigned char *output_pointer = NULL;
629: unsigned char *output = NULL;
631: /* not a string */
632: if (buffer_at_offset(input_buffer)[0] != '\"') { goto fail; }
634: {
635: /* calculate approximate size of the output (overestimate) */
636: size_t allocation_length = 0;
637: size_t skipped_bytes = 0;
638: while (((size_t)(input_end - input_buffer->content) < input_buffer->length) && (*input_end != '\"')) {
639: /* is escape sequence */
640: if (input_end[0] == '\\') {
641: if ((size_t)(input_end + 1 - input_buffer->content) >= input_buffer->length) {
642: /* prevent buffer overflow when last input character is a backslash */
643: goto fail;
644: }
645: skipped_bytes++;
646: input_end++;
647: }
648: input_end++;
649: }
650: if (((size_t)(input_end - input_buffer->content) >= input_buffer->length) || (*input_end != '\"')) { goto fail; /* string ended unexpectedly */ }
652: /* This is at most how much we need for the output */
653: allocation_length = (size_t)(input_end - buffer_at_offset(input_buffer)) - skipped_bytes;
654: output = (unsigned char *)input_buffer->hooks.allocate(allocation_length + sizeof(""));
655: if (output == NULL) { goto fail; /* allocation failure */ }
656: }
658: output_pointer = output;
659: /* loop through the string literal */
660: while (input_pointer < input_end) {
661: if (*input_pointer != '\\') {
662: *output_pointer++ = *input_pointer++;
663: }
664: /* escape sequence */
665: else {
666: unsigned char sequence_length = 2;
667: if ((input_end - input_pointer) < 1) { goto fail; }
669: switch (input_pointer[1]) {
670: case 'b':
671: *output_pointer++ = '\b';
672: break;
673: case 'f':
674: *output_pointer++ = '\f';
675: break;
676: case 'n':
677: *output_pointer++ = '\n';
678: break;
679: case 'r':
680: *output_pointer++ = '\r';
681: break;
682: case 't':
683: *output_pointer++ = '\t';
684: break;
685: case '\"':
686: case '\\':
687: case '/':
688: *output_pointer++ = input_pointer[1];
689: break;
691: /* UTF-16 literal */
692: case 'u':
693: sequence_length = utf16_literal_to_utf8(input_pointer, input_end, &output_pointer);
694: if (sequence_length == 0) {
695: /* failed to convert UTF16-literal to UTF-8 */
696: goto fail;
697: }
698: break;
700: default:
701: goto fail;
702: }
703: input_pointer += sequence_length;
704: }
705: }
707: /* zero terminate the output */
708: *output_pointer = '\0';
710: item->type = cJSON_String;
711: item->valuestring = (char *)output;
713: input_buffer->offset = (size_t)(input_end - input_buffer->content);
714: input_buffer->offset++;
716: return true;
718: fail:
719: if (output != NULL) { input_buffer->hooks.deallocate(output); }
721: if (input_pointer != NULL) { input_buffer->offset = (size_t)(input_pointer - input_buffer->content); }
723: return false;
724: }
726: /* Render the cstring provided to an escaped version that can be printed. */
727: static cJSON_bool print_string_ptr(const unsigned char *const input, printbuffer *const output_buffer)
728: {
729: const unsigned char *input_pointer = NULL;
730: unsigned char *output = NULL;
731: unsigned char *output_pointer = NULL;
732: size_t output_length = 0;
733: /* numbers of additional characters needed for escaping */
734: size_t escape_characters = 0;
736: if (output_buffer == NULL) { return false; }
738: /* empty string */
739: if (input == NULL) {
740: output = ensure(output_buffer, sizeof("\"\""));
741: if (output == NULL) { return false; }
742: strcpy((char *)output, "\"\"");
744: return true;
745: }
747: /* set "flag" to 1 if something needs to be escaped */
748: for (input_pointer = input; *input_pointer; input_pointer++) {
749: switch (*input_pointer) {
750: case '\"':
751: case '\\':
752: case '\b':
753: case '\f':
754: case '\n':
755: case '\r':
756: case '\t':
757: /* one character escape sequence */
758: escape_characters++;
759: break;
760: default:
761: if (*input_pointer < 32) {
762: /* UTF-16 escape sequence uXXXX */
763: escape_characters += 5;
764: }
765: break;
766: }
767: }
768: output_length = (size_t)(input_pointer - input) + escape_characters;
770: output = ensure(output_buffer, output_length + sizeof("\"\""));
771: if (output == NULL) { return false; }
773: /* no characters have to be escaped */
774: if (escape_characters == 0) {
775: output[0] = '\"';
776: memcpy(output + 1, input, output_length);
777: output[output_length + 1] = '\"';
778: output[output_length + 2] = '\0';
780: return true;
781: }
783: output[0] = '\"';
784: output_pointer = output + 1;
785: /* copy the string */
786: for (input_pointer = input; *input_pointer != '\0'; (void)input_pointer++, output_pointer++) {
787: if ((*input_pointer > 31) && (*input_pointer != '\"') && (*input_pointer != '\\')) {
788: /* normal character, copy */
789: *output_pointer = *input_pointer;
790: } else {
791: /* character needs to be escaped */
792: *output_pointer++ = '\\';
793: switch (*input_pointer) {
794: case '\\':
795: *output_pointer = '\\';
796: break;
797: case '\"':
798: *output_pointer = '\"';
799: break;
800: case '\b':
801: *output_pointer = 'b';
802: break;
803: case '\f':
804: *output_pointer = 'f';
805: break;
806: case '\n':
807: *output_pointer = 'n';
808: break;
809: case '\r':
810: *output_pointer = 'r';
811: break;
812: case '\t':
813: *output_pointer = 't';
814: break;
815: default:
816: /* escape and print as unicode codepoint */
817: snprintf((char *)output_pointer, 6, "u%04x", *input_pointer);
818: output_pointer += 5;
819: break;
820: }
821: }
822: }
823: output[output_length + 1] = '\"';
824: output[output_length + 2] = '\0';
826: return true;
827: }
829: /* Invoke print_string_ptr (which is useful) on an item. */
830: static cJSON_bool print_string(const cJSON *const item, printbuffer *const p)
831: {
832: return print_string_ptr((unsigned char *)item->valuestring, p);
833: }
835: /* Predeclare these prototypes. */
836: static cJSON_bool parse_value(cJSON *const item, parse_buffer *const input_buffer);
837: static cJSON_bool print_value(const cJSON *const item, printbuffer *const output_buffer);
838: static cJSON_bool parse_array(cJSON *const item, parse_buffer *const input_buffer);
839: static cJSON_bool print_array(const cJSON *const item, printbuffer *const output_buffer);
840: static cJSON_bool parse_object(cJSON *const item, parse_buffer *const input_buffer);
841: static cJSON_bool print_object(const cJSON *const item, printbuffer *const output_buffer);
843: /* Utility to jump whitespace and cr/lf */
844: static parse_buffer *buffer_skip_whitespace(parse_buffer *const buffer)
845: {
846: if ((buffer == NULL) || (buffer->content == NULL)) { return NULL; }
848: if (cannot_access_at_index(buffer, 0)) { return buffer; }
850: while (can_access_at_index(buffer, 0) && (buffer_at_offset(buffer)[0] <= 32)) { buffer->offset++; }
852: if (buffer->offset == buffer->length) { buffer->offset--; }
854: return buffer;
855: }
857: /* skip the UTF-8 BOM (byte order mark) if it is at the beginning of a buffer */
858: static parse_buffer *skip_utf8_bom(parse_buffer *const buffer)
859: {
860: if ((buffer == NULL) || (buffer->content == NULL) || (buffer->offset != 0)) { return NULL; }
862: if (can_access_at_index(buffer, 4) && (strncmp((const char *)buffer_at_offset(buffer), "\xEF\xBB\xBF", 3) == 0)) { buffer->offset += 3; }
864: return buffer;
865: }
867: CJSON_PUBLIC(cJSON *) cJSON_ParseWithOpts(const char *value, const char **return_parse_end, cJSON_bool require_null_terminated)
868: {
869: size_t buffer_length;
871: if (NULL == value) { return NULL; }
873: /* Adding null character size due to require_null_terminated. */
874: buffer_length = strlen(value) + sizeof("");
876: return cJSON_ParseWithLengthOpts(value, buffer_length, return_parse_end, require_null_terminated);
877: }
879: /* Parse an object - create a new root, and populate. */
880: CJSON_PUBLIC(cJSON *) cJSON_ParseWithLengthOpts(const char *value, size_t buffer_length, const char **return_parse_end, cJSON_bool require_null_terminated)
881: {
882: parse_buffer buffer = {
883: 0, 0, 0, 0, {0, 0, 0}
884: };
885: cJSON *item = NULL;
887: /* reset error position */
888: global_error.json = NULL;
889: global_error.position = 0;
891: if (value == NULL || 0 == buffer_length) { goto fail; }
893: buffer.content = (const unsigned char *)value;
894: buffer.length = buffer_length;
895: buffer.offset = 0;
896: buffer.hooks = global_hooks;
898: item = cJSON_New_Item(&global_hooks);
899: if (item == NULL) /* memory fail */
900: {
901: goto fail;
902: }
904: if (!parse_value(item, buffer_skip_whitespace(skip_utf8_bom(&buffer)))) {
905: /* parse failure. ep is set. */
906: goto fail;
907: }
909: /* if we require null-terminated JSON without appended garbage, skip and then check for a null terminator */
910: if (require_null_terminated) {
911: buffer_skip_whitespace(&buffer);
912: if ((buffer.offset >= buffer.length) || buffer_at_offset(&buffer)[0] != '\0') { goto fail; }
913: }
914: if (return_parse_end) { *return_parse_end = (const char *)buffer_at_offset(&buffer); }
916: return item;
918: fail:
919: if (item != NULL) { cJSON_Delete(item); }
921: if (value != NULL) {
922: error local_error;
923: local_error.json = (const unsigned char *)value;
924: local_error.position = 0;
926: if (buffer.offset < buffer.length) {
927: local_error.position = buffer.offset;
928: } else if (buffer.length > 0) {
929: local_error.position = buffer.length - 1;
930: }
932: if (return_parse_end != NULL) { *return_parse_end = (const char *)local_error.json + local_error.position; }
934: global_error = local_error;
935: }
937: return NULL;
938: }
940: /* Default options for cJSON_Parse */
941: CJSON_PUBLIC(cJSON *) cJSON_Parse(const char *value)
942: {
943: return cJSON_ParseWithOpts(value, 0, 0);
944: }
946: CJSON_PUBLIC(cJSON *) cJSON_ParseWithLength(const char *value, size_t buffer_length)
947: {
948: return cJSON_ParseWithLengthOpts(value, buffer_length, 0, 0);
949: }
951: #define cjson_min(a, b) (((a) < (b)) ? (a) : (b))
953: static unsigned char *print(const cJSON *const item, cJSON_bool format, const internal_hooks *const hooks)
954: {
955: static const size_t default_buffer_size = 256;
956: printbuffer buffer[1];
957: unsigned char *printed = NULL;
959: memset(buffer, 0, sizeof(buffer));
961: /* create buffer */
962: buffer->buffer = (unsigned char *)hooks->allocate(default_buffer_size);
963: buffer->length = default_buffer_size;
964: buffer->format = format;
965: buffer->hooks = *hooks;
966: if (buffer->buffer == NULL) { goto fail; }
968: /* print the value */
969: if (!print_value(item, buffer)) { goto fail; }
970: update_offset(buffer);
972: /* check if reallocate is available */
973: if (hooks->reallocate != NULL) {
974: printed = (unsigned char *)hooks->reallocate(buffer->buffer, buffer->offset + 1);
975: if (printed == NULL) { goto fail; }
976: buffer->buffer = NULL;
977: } else /* otherwise copy the JSON over to a new buffer */
978: {
979: printed = (unsigned char *)hooks->allocate(buffer->offset + 1);
980: if (printed == NULL) { goto fail; }
981: memcpy(printed, buffer->buffer, cjson_min(buffer->length, buffer->offset + 1));
982: printed[buffer->offset] = '\0'; /* just to be sure */
984: /* free the buffer */
985: hooks->deallocate(buffer->buffer);
986: }
988: return printed;
990: fail:
991: if (buffer->buffer != NULL) { hooks->deallocate(buffer->buffer); }
993: if (printed != NULL) { hooks->deallocate(printed); }
995: return NULL;
996: }
998: /* Render a cJSON item/entity/structure to text. */
999: CJSON_PUBLIC(char *) cJSON_Print(const cJSON *item)
1000: {
1001: return (char *)print(item, true, &global_hooks);
1002: }
1004: CJSON_PUBLIC(char *) cJSON_PrintUnformatted(const cJSON *item)
1005: {
1006: return (char *)print(item, false, &global_hooks);
1007: }
1009: CJSON_PUBLIC(char *) cJSON_PrintBuffered(const cJSON *item, int prebuffer, cJSON_bool fmt)
1010: {
1011: printbuffer p = {
1012: 0, 0, 0, 0, 0, 0, {0, 0, 0}
1013: };
1015: if (prebuffer < 0) { return NULL; }
1017: p.buffer = (unsigned char *)global_hooks.allocate((size_t)prebuffer);
1018: if (!p.buffer) { return NULL; }
1020: p.length = (size_t)prebuffer;
1021: p.offset = 0;
1022: p.noalloc = false;
1023: p.format = fmt;
1024: p.hooks = global_hooks;
1026: if (!print_value(item, &p)) {
1027: global_hooks.deallocate(p.buffer);
1028: return NULL;
1029: }
1031: return (char *)p.buffer;
1032: }
1034: CJSON_PUBLIC(cJSON_bool) cJSON_PrintPreallocated(cJSON *item, char *buffer, const int length, const cJSON_bool format)
1035: {
1036: printbuffer p = {
1037: 0, 0, 0, 0, 0, 0, {0, 0, 0}
1038: };
1040: if ((length < 0) || (buffer == NULL)) { return false; }
1042: p.buffer = (unsigned char *)buffer;
1043: p.length = (size_t)length;
1044: p.offset = 0;
1045: p.noalloc = true;
1046: p.format = format;
1047: p.hooks = global_hooks;
1049: return print_value(item, &p);
1050: }
1052: /* Parser core - when encountering text, process appropriately. */
1053: static cJSON_bool parse_value(cJSON *const item, parse_buffer *const input_buffer)
1054: {
1055: if ((input_buffer == NULL) || (input_buffer->content == NULL)) { return false; /* no input */ }
1057: /* parse the different types of values */
1058: /* null */
1059: if (can_read(input_buffer, 4) && (strncmp((const char *)buffer_at_offset(input_buffer), "null", 4) == 0)) {
1060: item->type = cJSON_NULL;
1061: input_buffer->offset += 4;
1062: return true;
1063: }
1064: /* false */
1065: if (can_read(input_buffer, 5) && (strncmp((const char *)buffer_at_offset(input_buffer), "false", 5) == 0)) {
1066: item->type = cJSON_False;
1067: input_buffer->offset += 5;
1068: return true;
1069: }
1070: /* true */
1071: if (can_read(input_buffer, 4) && (strncmp((const char *)buffer_at_offset(input_buffer), "true", 4) == 0)) {
1072: item->type = cJSON_True;
1073: item->valueint = 1;
1074: input_buffer->offset += 4;
1075: return true;
1076: }
1077: /* string */
1078: if (can_access_at_index(input_buffer, 0) && (buffer_at_offset(input_buffer)[0] == '\"')) { return parse_string(item, input_buffer); }
1079: /* number */
1080: if (can_access_at_index(input_buffer, 0) && ((buffer_at_offset(input_buffer)[0] == '-') || ((buffer_at_offset(input_buffer)[0] >= '0') && (buffer_at_offset(input_buffer)[0] <= '9')))) { return parse_number(item, input_buffer); }
1081: /* array */
1082: if (can_access_at_index(input_buffer, 0) && (buffer_at_offset(input_buffer)[0] == '[')) { return parse_array(item, input_buffer); }
1083: /* object */
1084: if (can_access_at_index(input_buffer, 0) && (buffer_at_offset(input_buffer)[0] == '{')) { return parse_object(item, input_buffer); }
1086: return false;
1087: }
1089: /* Render a value to text. */
1090: static cJSON_bool print_value(const cJSON *const item, printbuffer *const output_buffer)
1091: {
1092: unsigned char *output = NULL;
1094: if ((item == NULL) || (output_buffer == NULL)) { return false; }
1096: switch ((item->type) & 0xFF) {
1097: case cJSON_NULL:
1098: output = ensure(output_buffer, 5);
1099: if (output == NULL) { return false; }
1100: strcpy((char *)output, "null");
1101: return true;
1103: case cJSON_False:
1104: output = ensure(output_buffer, 6);
1105: if (output == NULL) { return false; }
1106: strcpy((char *)output, "false");
1107: return true;
1109: case cJSON_True:
1110: output = ensure(output_buffer, 5);
1111: if (output == NULL) { return false; }
1112: strcpy((char *)output, "true");
1113: return true;
1115: case cJSON_Number:
1116: return print_number(item, output_buffer);
1118: case cJSON_Raw: {
1119: size_t raw_length = 0;
1120: if (item->valuestring == NULL) { return false; }
1122: raw_length = strlen(item->valuestring) + sizeof("");
1123: output = ensure(output_buffer, raw_length);
1124: if (output == NULL) { return false; }
1125: memcpy(output, item->valuestring, raw_length);
1126: return true;
1127: }
1129: case cJSON_String:
1130: return print_string(item, output_buffer);
1132: case cJSON_Array:
1133: return print_array(item, output_buffer);
1135: case cJSON_Object:
1136: return print_object(item, output_buffer);
1138: default:
1139: return false;
1140: }
1141: }
1143: /* Build an array from input text. */
1144: static cJSON_bool parse_array(cJSON *const item, parse_buffer *const input_buffer)
1145: {
1146: cJSON *head = NULL; /* head of the linked list */
1147: cJSON *current_item = NULL;
1149: if (input_buffer->depth >= CJSON_NESTING_LIMIT) { return false; /* to deeply nested */ }
1150: input_buffer->depth++;
1152: if (buffer_at_offset(input_buffer)[0] != '[') {
1153: /* not an array */
1154: goto fail;
1155: }
1157: input_buffer->offset++;
1158: buffer_skip_whitespace(input_buffer);
1159: if (can_access_at_index(input_buffer, 0) && (buffer_at_offset(input_buffer)[0] == ']')) {
1160: /* empty array */
1161: goto success;
1162: }
1164: /* check if we skipped to the end of the buffer */
1165: if (cannot_access_at_index(input_buffer, 0)) {
1166: input_buffer->offset--;
1167: goto fail;
1168: }
1170: /* step back to character in front of the first element */
1171: input_buffer->offset--;
1172: /* loop through the comma separated array elements */
1173: do {
1174: /* allocate next item */
1175: cJSON *new_item = cJSON_New_Item(&(input_buffer->hooks));
1176: if (new_item == NULL) { goto fail; /* allocation failure */ }
1178: /* attach next item to list */
1179: if (head == NULL) {
1180: /* start the linked list */
1181: current_item = head = new_item;
1182: } else {
1183: /* add to the end and advance */
1184: current_item->next = new_item;
1185: new_item->prev = current_item;
1186: current_item = new_item;
1187: }
1189: /* parse next value */
1190: input_buffer->offset++;
1191: buffer_skip_whitespace(input_buffer);
1192: if (!parse_value(current_item, input_buffer)) { goto fail; /* failed to parse value */ }
1193: buffer_skip_whitespace(input_buffer);
1194: } while (can_access_at_index(input_buffer, 0) && (buffer_at_offset(input_buffer)[0] == ','));
1196: if (cannot_access_at_index(input_buffer, 0) || buffer_at_offset(input_buffer)[0] != ']') { goto fail; /* expected end of array */ }
1198: success:
1199: input_buffer->depth--;
1201: if (head != NULL) { head->prev = current_item; }
1203: item->type = cJSON_Array;
1204: item->child = head;
1206: input_buffer->offset++;
1208: return true;
1210: fail:
1211: if (head != NULL) { cJSON_Delete(head); }
1213: return false;
1214: }
1216: /* Render an array to text */
1217: static cJSON_bool print_array(const cJSON *const item, printbuffer *const output_buffer)
1218: {
1219: unsigned char *output_pointer = NULL;
1220: size_t length = 0;
1221: cJSON *current_element = item->child;
1223: if (output_buffer == NULL) { return false; }
1225: /* Compose the output array. */
1226: /* opening square bracket */
1227: output_pointer = ensure(output_buffer, 1);
1228: if (output_pointer == NULL) { return false; }
1230: *output_pointer = '[';
1231: output_buffer->offset++;
1232: output_buffer->depth++;
1234: while (current_element != NULL) {
1235: if (!print_value(current_element, output_buffer)) { return false; }
1236: update_offset(output_buffer);
1237: if (current_element->next) {
1238: length = (size_t)(output_buffer->format ? 2 : 1);
1239: output_pointer = ensure(output_buffer, length + 1);
1240: if (output_pointer == NULL) { return false; }
1241: *output_pointer++ = ',';
1242: if (output_buffer->format) { *output_pointer++ = ' '; }
1243: *output_pointer = '\0';
1244: output_buffer->offset += length;
1245: }
1246: current_element = current_element->next;
1247: }
1249: output_pointer = ensure(output_buffer, 2);
1250: if (output_pointer == NULL) { return false; }
1251: *output_pointer++ = ']';
1252: *output_pointer = '\0';
1253: output_buffer->depth--;
1255: return true;
1256: }
1258: /* Build an object from the text. */
1259: static cJSON_bool parse_object(cJSON *const item, parse_buffer *const input_buffer)
1260: {
1261: cJSON *head = NULL; /* linked list head */
1262: cJSON *current_item = NULL;
1264: if (input_buffer->depth >= CJSON_NESTING_LIMIT) { return false; /* to deeply nested */ }
1265: input_buffer->depth++;
1267: if (cannot_access_at_index(input_buffer, 0) || (buffer_at_offset(input_buffer)[0] != '{')) { goto fail; /* not an object */ }
1269: input_buffer->offset++;
1270: buffer_skip_whitespace(input_buffer);
1271: if (can_access_at_index(input_buffer, 0) && (buffer_at_offset(input_buffer)[0] == '}')) { goto success; /* empty object */ }
1273: /* check if we skipped to the end of the buffer */
1274: if (cannot_access_at_index(input_buffer, 0)) {
1275: input_buffer->offset--;
1276: goto fail;
1277: }
1279: /* step back to character in front of the first element */
1280: input_buffer->offset--;
1281: /* loop through the comma separated array elements */
1282: do {
1283: /* allocate next item */
1284: cJSON *new_item = cJSON_New_Item(&(input_buffer->hooks));
1285: if (new_item == NULL) { goto fail; /* allocation failure */ }
1287: /* attach next item to list */
1288: if (head == NULL) {
1289: /* start the linked list */
1290: current_item = head = new_item;
1291: } else {
1292: /* add to the end and advance */
1293: current_item->next = new_item;
1294: new_item->prev = current_item;
1295: current_item = new_item;
1296: }
1298: /* parse the name of the child */
1299: input_buffer->offset++;
1300: buffer_skip_whitespace(input_buffer);
1301: if (!parse_string(current_item, input_buffer)) { goto fail; /* failed to parse name */ }
1302: buffer_skip_whitespace(input_buffer);
1304: /* swap valuestring and string, because we parsed the name */
1305: current_item->string = current_item->valuestring;
1306: current_item->valuestring = NULL;
1308: if (cannot_access_at_index(input_buffer, 0) || (buffer_at_offset(input_buffer)[0] != ':')) { goto fail; /* invalid object */ }
1310: /* parse the value */
1311: input_buffer->offset++;
1312: buffer_skip_whitespace(input_buffer);
1313: if (!parse_value(current_item, input_buffer)) { goto fail; /* failed to parse value */ }
1314: buffer_skip_whitespace(input_buffer);
1315: } while (can_access_at_index(input_buffer, 0) && (buffer_at_offset(input_buffer)[0] == ','));
1317: if (cannot_access_at_index(input_buffer, 0) || (buffer_at_offset(input_buffer)[0] != '}')) { goto fail; /* expected end of object */ }
1319: success:
1320: input_buffer->depth--;
1322: if (head != NULL) { head->prev = current_item; }
1324: item->type = cJSON_Object;
1325: item->child = head;
1327: input_buffer->offset++;
1328: return true;
1330: fail:
1331: if (head != NULL) { cJSON_Delete(head); }
1333: return false;
1334: }
1336: /* Render an object to text. */
1337: static cJSON_bool print_object(const cJSON *const item, printbuffer *const output_buffer)
1338: {
1339: unsigned char *output_pointer = NULL;
1340: size_t length = 0;
1341: cJSON *current_item = item->child;
1343: if (output_buffer == NULL) { return false; }
1345: /* Compose the output: */
1346: length = (size_t)(output_buffer->format ? 2 : 1); /* fmt: {\n */
1347: output_pointer = ensure(output_buffer, length + 1);
1348: if (output_pointer == NULL) { return false; }
1350: *output_pointer++ = '{';
1351: output_buffer->depth++;
1352: if (output_buffer->format) { *output_pointer++ = '\n'; }
1353: output_buffer->offset += length;
1355: while (current_item) {
1356: if (output_buffer->format) {
1357: size_t i;
1358: output_pointer = ensure(output_buffer, output_buffer->depth);
1359: if (output_pointer == NULL) { return false; }
1360: for (i = 0; i < output_buffer->depth; i++) { *output_pointer++ = '\t'; }
1361: output_buffer->offset += output_buffer->depth;
1362: }
1364: /* print key */
1365: if (!print_string_ptr((unsigned char *)current_item->string, output_buffer)) { return false; }
1366: update_offset(output_buffer);
1368: length = (size_t)(output_buffer->format ? 2 : 1);
1369: output_pointer = ensure(output_buffer, length);
1370: if (output_pointer == NULL) { return false; }
1371: *output_pointer++ = ':';
1372: if (output_buffer->format) { *output_pointer++ = '\t'; }
1373: output_buffer->offset += length;
1375: /* print value */
1376: if (!print_value(current_item, output_buffer)) { return false; }
1377: update_offset(output_buffer);
1379: /* print comma if not last */
1380: length = ((size_t)(output_buffer->format ? 1 : 0) + (size_t)(current_item->next ? 1 : 0));
1381: output_pointer = ensure(output_buffer, length + 1);
1382: if (output_pointer == NULL) { return false; }
1383: if (current_item->next) { *output_pointer++ = ','; }
1385: if (output_buffer->format) { *output_pointer++ = '\n'; }
1386: *output_pointer = '\0';
1387: output_buffer->offset += length;
1389: current_item = current_item->next;
1390: }
1392: output_pointer = ensure(output_buffer, output_buffer->format ? (output_buffer->depth + 1) : 2);
1393: if (output_pointer == NULL) { return false; }
1394: if (output_buffer->format) {
1395: size_t i;
1396: for (i = 0; i < (output_buffer->depth - 1); i++) { *output_pointer++ = '\t'; }
1397: }
1398: *output_pointer++ = '}';
1399: *output_pointer = '\0';
1400: output_buffer->depth--;
1402: return true;
1403: }
1405: /* Get Array size/item / object item. */
1406: CJSON_PUBLIC(int) cJSON_GetArraySize(const cJSON *array)
1407: {
1408: cJSON *child = NULL;
1409: size_t size = 0;
1411: if (array == NULL) { return 0; }
1413: child = array->child;
1415: while (child != NULL) {
1416: size++;
1417: child = child->next;
1418: }
1420: /* FIXME: Can overflow here. Cannot be fixed without breaking the API */
1422: return (int)size;
1423: }
1425: static cJSON *get_array_item(const cJSON *array, size_t index)
1426: {
1427: cJSON *current_child = NULL;
1429: if (array == NULL) { return NULL; }
1431: current_child = array->child;
1432: while ((current_child != NULL) && (index > 0)) {
1433: index--;
1434: current_child = current_child->next;
1435: }
1437: return current_child;
1438: }
1440: CJSON_PUBLIC(cJSON *) cJSON_GetArrayItem(const cJSON *array, int index)
1441: {
1442: if (index < 0) { return NULL; }
1444: return get_array_item(array, (size_t)index);
1445: }
1447: static cJSON *get_object_item(const cJSON *const object, const char *const name, const cJSON_bool case_sensitive)
1448: {
1449: cJSON *current_element = NULL;
1451: if ((object == NULL) || (name == NULL)) { return NULL; }
1453: current_element = object->child;
1454: if (case_sensitive) {
1455: while ((current_element != NULL) && (current_element->string != NULL) && (strcmp(name, current_element->string) != 0)) { current_element = current_element->next; }
1456: } else {
1457: while ((current_element != NULL) && (case_insensitive_strcmp((const unsigned char *)name, (const unsigned char *)(current_element->string)) != 0)) { current_element = current_element->next; }
1458: }
1460: if ((current_element == NULL) || (current_element->string == NULL)) { return NULL; }
1462: return current_element;
1463: }
1465: CJSON_PUBLIC(cJSON *) cJSON_GetObjectItem(const cJSON *const object, const char *const string)
1466: {
1467: return get_object_item(object, string, false);
1468: }
1470: CJSON_PUBLIC(cJSON *) cJSON_GetObjectItemCaseSensitive(const cJSON *const object, const char *const string)
1471: {
1472: return get_object_item(object, string, true);
1473: }
1475: CJSON_PUBLIC(cJSON_bool) cJSON_HasObjectItem(const cJSON *object, const char *string)
1476: {
1477: return cJSON_GetObjectItem(object, string) ? 1 : 0;
1478: }
1480: /* Utility for array list handling. */
1481: static void suffix_object(cJSON *prev, cJSON *item)
1482: {
1483: prev->next = item;
1484: item->prev = prev;
1485: }
1487: /* Utility for handling references. */
1488: static cJSON *create_reference(const cJSON *item, const internal_hooks *const hooks)
1489: {
1490: cJSON *reference = NULL;
1491: if (item == NULL) { return NULL; }
1493: reference = cJSON_New_Item(hooks);
1494: if (reference == NULL) { return NULL; }
1496: memcpy(reference, item, sizeof(cJSON));
1497: reference->string = NULL;
1498: reference->type |= cJSON_IsReference;
1499: reference->next = reference->prev = NULL;
1500: return reference;
1501: }
1503: static cJSON_bool add_item_to_array(cJSON *array, cJSON *item)
1504: {
1505: cJSON *child = NULL;
1507: if ((item == NULL) || (array == NULL) || (array == item)) { return false; }
1509: child = array->child;
1510: /*
1511: * To find the last item in array quickly, we use prev in array
1512: */
1513: if (child == NULL) {
1514: /* list is empty, start new one */
1515: array->child = item;
1516: item->prev = item;
1517: item->next = NULL;
1518: } else {
1519: /* append to the end */
1520: if (child->prev) {
1521: suffix_object(child->prev, item);
1522: array->child->prev = item;
1523: }
1524: }
1526: return true;
1527: }
1529: /* Add item to array/object. */
1530: CJSON_PUBLIC(cJSON_bool) cJSON_AddItemToArray(cJSON *array, cJSON *item)
1531: {
1532: return add_item_to_array(array, item);
1533: }
1535: #if defined(__clang__) || (defined(__GNUC__) && ((__GNUC__ > 4) || ((__GNUC__ == 4) && (__GNUC_MINOR__ > 5))))
1536: #pragma GCC diagnostic push
1537: #endif
1538: #ifdef __GNUC__
1539: #pragma GCC diagnostic ignored "-Wcast-qual"
1540: #endif
1541: /* helper function to cast away const */
1542: static void *cast_away_const(const void *string)
1543: {
1544: return (void *)string;
1545: }
1546: #if defined(__clang__) || (defined(__GNUC__) && ((__GNUC__ > 4) || ((__GNUC__ == 4) && (__GNUC_MINOR__ > 5))))
1547: #pragma GCC diagnostic pop
1548: #endif
1550: static cJSON_bool add_item_to_object(cJSON *const object, const char *const string, cJSON *const item, const internal_hooks *const hooks, const cJSON_bool constant_key)
1551: {
1552: char *new_key = NULL;
1553: int new_type = cJSON_Invalid;
1555: if ((object == NULL) || (string == NULL) || (item == NULL) || (object == item)) { return false; }
1557: if (constant_key) {
1558: new_key = (char *)cast_away_const(string);
1559: new_type = item->type | cJSON_StringIsConst;
1560: } else {
1561: new_key = (char *)cJSON_strdup((const unsigned char *)string, hooks);
1562: if (new_key == NULL) { return false; }
1564: new_type = item->type & ~cJSON_StringIsConst;
1565: }
1567: if (!(item->type & cJSON_StringIsConst) && (item->string != NULL)) { hooks->deallocate(item->string); }
1569: item->string = new_key;
1570: item->type = new_type;
1572: return add_item_to_array(object, item);
1573: }
1575: CJSON_PUBLIC(cJSON_bool) cJSON_AddItemToObject(cJSON *object, const char *string, cJSON *item)
1576: {
1577: return add_item_to_object(object, string, item, &global_hooks, false);
1578: }
1580: /* Add an item to an object with constant string as key */
1581: CJSON_PUBLIC(cJSON_bool) cJSON_AddItemToObjectCS(cJSON *object, const char *string, cJSON *item)
1582: {
1583: return add_item_to_object(object, string, item, &global_hooks, true);
1584: }
1586: CJSON_PUBLIC(cJSON_bool) cJSON_AddItemReferenceToArray(cJSON *array, cJSON *item)
1587: {
1588: if (array == NULL) { return false; }
1590: return add_item_to_array(array, create_reference(item, &global_hooks));
1591: }
1593: CJSON_PUBLIC(cJSON_bool) cJSON_AddItemReferenceToObject(cJSON *object, const char *string, cJSON *item)
1594: {
1595: if ((object == NULL) || (string == NULL)) { return false; }
1597: return add_item_to_object(object, string, create_reference(item, &global_hooks), &global_hooks, false);
1598: }
1600: CJSON_PUBLIC(cJSON *) cJSON_AddNullToObject(cJSON *const object, const char *const name)
1601: {
1602: cJSON *null = cJSON_CreateNull();
1603: if (add_item_to_object(object, name, null, &global_hooks, false)) { return null; }
1605: cJSON_Delete(null);
1606: return NULL;
1607: }
1609: CJSON_PUBLIC(cJSON *) cJSON_AddTrueToObject(cJSON *const object, const char *const name)
1610: {
1611: cJSON *true_item = cJSON_CreateTrue();
1612: if (add_item_to_object(object, name, true_item, &global_hooks, false)) { return true_item; }
1614: cJSON_Delete(true_item);
1615: return NULL;
1616: }
1618: CJSON_PUBLIC(cJSON *) cJSON_AddFalseToObject(cJSON *const object, const char *const name)
1619: {
1620: cJSON *false_item = cJSON_CreateFalse();
1621: if (add_item_to_object(object, name, false_item, &global_hooks, false)) { return false_item; }
1623: cJSON_Delete(false_item);
1624: return NULL;
1625: }
1627: CJSON_PUBLIC(cJSON *) cJSON_AddBoolToObject(cJSON *const object, const char *const name, const cJSON_bool boolean)
1628: {
1629: cJSON *bool_item = cJSON_CreateBool(boolean);
1630: if (add_item_to_object(object, name, bool_item, &global_hooks, false)) { return bool_item; }
1632: cJSON_Delete(bool_item);
1633: return NULL;
1634: }
1636: CJSON_PUBLIC(cJSON *) cJSON_AddNumberToObject(cJSON *const object, const char *const name, const double number)
1637: {
1638: cJSON *number_item = cJSON_CreateNumber(number);
1639: if (add_item_to_object(object, name, number_item, &global_hooks, false)) { return number_item; }
1641: cJSON_Delete(number_item);
1642: return NULL;
1643: }
1645: CJSON_PUBLIC(cJSON *) cJSON_AddStringToObject(cJSON *const object, const char *const name, const char *const string)
1646: {
1647: cJSON *string_item = cJSON_CreateString(string);
1648: if (add_item_to_object(object, name, string_item, &global_hooks, false)) { return string_item; }
1650: cJSON_Delete(string_item);
1651: return NULL;
1652: }
1654: CJSON_PUBLIC(cJSON *) cJSON_AddRawToObject(cJSON *const object, const char *const name, const char *const raw)
1655: {
1656: cJSON *raw_item = cJSON_CreateRaw(raw);
1657: if (add_item_to_object(object, name, raw_item, &global_hooks, false)) { return raw_item; }
1659: cJSON_Delete(raw_item);
1660: return NULL;
1661: }
1663: CJSON_PUBLIC(cJSON *) cJSON_AddObjectToObject(cJSON *const object, const char *const name)
1664: {
1665: cJSON *object_item = cJSON_CreateObject();
1666: if (add_item_to_object(object, name, object_item, &global_hooks, false)) { return object_item; }
1668: cJSON_Delete(object_item);
1669: return NULL;
1670: }
1672: CJSON_PUBLIC(cJSON *) cJSON_AddArrayToObject(cJSON *const object, const char *const name)
1673: {
1674: cJSON *array = cJSON_CreateArray();
1675: if (add_item_to_object(object, name, array, &global_hooks, false)) { return array; }
1677: cJSON_Delete(array);
1678: return NULL;
1679: }
1681: CJSON_PUBLIC(cJSON *) cJSON_DetachItemViaPointer(cJSON *parent, cJSON *const item)
1682: {
1683: if ((parent == NULL) || (item == NULL)) { return NULL; }
1685: if (item != parent->child) {
1686: /* not the first element */
1687: item->prev->next = item->next;
1688: }
1689: if (item->next != NULL) {
1690: /* not the last element */
1691: item->next->prev = item->prev;
1692: }
1694: if (item == parent->child) {
1695: /* first element */
1696: parent->child = item->next;
1697: } else if (item->next == NULL) {
1698: /* last element */
1699: parent->child->prev = item->prev;
1700: }
1702: /* make sure the detached item doesn't point anywhere anymore */
1703: item->prev = NULL;
1704: item->next = NULL;
1706: return item;
1707: }
1709: CJSON_PUBLIC(cJSON *) cJSON_DetachItemFromArray(cJSON *array, int which)
1710: {
1711: if (which < 0) { return NULL; }
1713: return cJSON_DetachItemViaPointer(array, get_array_item(array, (size_t)which));
1714: }
1716: CJSON_PUBLIC(void) cJSON_DeleteItemFromArray(cJSON *array, int which)
1717: {
1718: cJSON_Delete(cJSON_DetachItemFromArray(array, which));
1719: }
1721: CJSON_PUBLIC(cJSON *) cJSON_DetachItemFromObject(cJSON *object, const char *string)
1722: {
1723: cJSON *to_detach = cJSON_GetObjectItem(object, string);
1725: return cJSON_DetachItemViaPointer(object, to_detach);
1726: }
1728: CJSON_PUBLIC(cJSON *) cJSON_DetachItemFromObjectCaseSensitive(cJSON *object, const char *string)
1729: {
1730: cJSON *to_detach = cJSON_GetObjectItemCaseSensitive(object, string);
1732: return cJSON_DetachItemViaPointer(object, to_detach);
1733: }
1735: CJSON_PUBLIC(void) cJSON_DeleteItemFromObject(cJSON *object, const char *string)
1736: {
1737: cJSON_Delete(cJSON_DetachItemFromObject(object, string));
1738: }
1740: CJSON_PUBLIC(void) cJSON_DeleteItemFromObjectCaseSensitive(cJSON *object, const char *string)
1741: {
1742: cJSON_Delete(cJSON_DetachItemFromObjectCaseSensitive(object, string));
1743: }
1745: /* Replace array/object items with new ones. */
1746: CJSON_PUBLIC(cJSON_bool) cJSON_InsertItemInArray(cJSON *array, int which, cJSON *newitem)
1747: {
1748: cJSON *after_inserted = NULL;
1750: if (which < 0) { return false; }
1752: after_inserted = get_array_item(array, (size_t)which);
1753: if (after_inserted == NULL) { return add_item_to_array(array, newitem); }
1755: newitem->next = after_inserted;
1756: newitem->prev = after_inserted->prev;
1757: after_inserted->prev = newitem;
1758: if (after_inserted == array->child) {
1759: array->child = newitem;
1760: } else {
1761: newitem->prev->next = newitem;
1762: }
1763: return true;
1764: }
1766: CJSON_PUBLIC(cJSON_bool) cJSON_ReplaceItemViaPointer(cJSON *const parent, cJSON *const item, cJSON *replacement)
1767: {
1768: if ((parent == NULL) || (replacement == NULL) || (item == NULL)) { return false; }
1770: if (replacement == item) { return true; }
1772: replacement->next = item->next;
1773: replacement->prev = item->prev;
1775: if (replacement->next != NULL) { replacement->next->prev = replacement; }
1776: if (parent->child == item) {
1777: if (parent->child->prev == parent->child) { replacement->prev = replacement; }
1778: parent->child = replacement;
1779: } else { /*
1780: * To find the last item in array quickly, we use prev in array.
1781: * We can't modify the last item's next pointer where this item was the parent's child
1782: */
1783: if (replacement->prev != NULL) { replacement->prev->next = replacement; }
1784: if (replacement->next == NULL) { parent->child->prev = replacement; }
1785: }
1787: item->next = NULL;
1788: item->prev = NULL;
1789: cJSON_Delete(item);
1791: return true;
1792: }
1794: CJSON_PUBLIC(cJSON_bool) cJSON_ReplaceItemInArray(cJSON *array, int which, cJSON *newitem)
1795: {
1796: if (which < 0) { return false; }
1798: return cJSON_ReplaceItemViaPointer(array, get_array_item(array, (size_t)which), newitem);
1799: }
1801: static cJSON_bool replace_item_in_object(cJSON *object, const char *string, cJSON *replacement, cJSON_bool case_sensitive)
1802: {
1803: if ((replacement == NULL) || (string == NULL)) { return false; }
1805: /* replace the name in the replacement */
1806: if (!(replacement->type & cJSON_StringIsConst) && (replacement->string != NULL)) { cJSON_free(replacement->string); }
1807: replacement->string = (char *)cJSON_strdup((const unsigned char *)string, &global_hooks);
1808: if (replacement->string == NULL) { return false; }
1810: replacement->type &= ~cJSON_StringIsConst;
1812: return cJSON_ReplaceItemViaPointer(object, get_object_item(object, string, case_sensitive), replacement);
1813: }
1815: CJSON_PUBLIC(cJSON_bool) cJSON_ReplaceItemInObject(cJSON *object, const char *string, cJSON *newitem)
1816: {
1817: return replace_item_in_object(object, string, newitem, false);
1818: }
1820: CJSON_PUBLIC(cJSON_bool) cJSON_ReplaceItemInObjectCaseSensitive(cJSON *object, const char *string, cJSON *newitem)
1821: {
1822: return replace_item_in_object(object, string, newitem, true);
1823: }
1825: /* Create basic types: */
1826: CJSON_PUBLIC(cJSON *) cJSON_CreateNull(void)
1827: {
1828: cJSON *item = cJSON_New_Item(&global_hooks);
1829: if (item) { item->type = cJSON_NULL; }
1831: return item;
1832: }
1834: CJSON_PUBLIC(cJSON *) cJSON_CreateTrue(void)
1835: {
1836: cJSON *item = cJSON_New_Item(&global_hooks);
1837: if (item) { item->type = cJSON_True; }
1839: return item;
1840: }
1842: CJSON_PUBLIC(cJSON *) cJSON_CreateFalse(void)
1843: {
1844: cJSON *item = cJSON_New_Item(&global_hooks);
1845: if (item) { item->type = cJSON_False; }
1847: return item;
1848: }
1850: CJSON_PUBLIC(cJSON *) cJSON_CreateBool(cJSON_bool boolean)
1851: {
1852: cJSON *item = cJSON_New_Item(&global_hooks);
1853: if (item) { item->type = boolean ? cJSON_True : cJSON_False; }
1855: return item;
1856: }
1858: CJSON_PUBLIC(cJSON *) cJSON_CreateNumber(double num)
1859: {
1860: cJSON *item = cJSON_New_Item(&global_hooks);
1861: if (item) {
1862: item->type = cJSON_Number;
1863: item->valuedouble = num;
1865: /* use saturation in case of overflow */
1866: if (num >= INT_MAX) {
1867: item->valueint = INT_MAX;
1868: } else if (num <= (double)INT_MIN) {
1869: item->valueint = INT_MIN;
1870: } else {
1871: item->valueint = (int)num;
1872: }
1873: }
1875: return item;
1876: }
1878: CJSON_PUBLIC(cJSON *) cJSON_CreateString(const char *string)
1879: {
1880: cJSON *item = cJSON_New_Item(&global_hooks);
1881: if (item) {
1882: item->type = cJSON_String;
1883: item->valuestring = (char *)cJSON_strdup((const unsigned char *)string, &global_hooks);
1884: if (!item->valuestring) {
1885: cJSON_Delete(item);
1886: return NULL;
1887: }
1888: }
1890: return item;
1891: }
1893: CJSON_PUBLIC(cJSON *) cJSON_CreateStringReference(const char *string)
1894: {
1895: cJSON *item = cJSON_New_Item(&global_hooks);
1896: if (item != NULL) {
1897: item->type = cJSON_String | cJSON_IsReference;
1898: item->valuestring = (char *)cast_away_const(string);
1899: }
1901: return item;
1902: }
1904: CJSON_PUBLIC(cJSON *) cJSON_CreateObjectReference(const cJSON *child)
1905: {
1906: cJSON *item = cJSON_New_Item(&global_hooks);
1907: if (item != NULL) {
1908: item->type = cJSON_Object | cJSON_IsReference;
1909: item->child = (cJSON *)cast_away_const(child);
1910: }
1912: return item;
1913: }
1915: CJSON_PUBLIC(cJSON *) cJSON_CreateArrayReference(const cJSON *child)
1916: {
1917: cJSON *item = cJSON_New_Item(&global_hooks);
1918: if (item != NULL) {
1919: item->type = cJSON_Array | cJSON_IsReference;
1920: item->child = (cJSON *)cast_away_const(child);
1921: }
1923: return item;
1924: }
1926: CJSON_PUBLIC(cJSON *) cJSON_CreateRaw(const char *raw)
1927: {
1928: cJSON *item = cJSON_New_Item(&global_hooks);
1929: if (item) {
1930: item->type = cJSON_Raw;
1931: item->valuestring = (char *)cJSON_strdup((const unsigned char *)raw, &global_hooks);
1932: if (!item->valuestring) {
1933: cJSON_Delete(item);
1934: return NULL;
1935: }
1936: }
1938: return item;
1939: }
1941: CJSON_PUBLIC(cJSON *) cJSON_CreateArray(void)
1942: {
1943: cJSON *item = cJSON_New_Item(&global_hooks);
1944: if (item) { item->type = cJSON_Array; }
1946: return item;
1947: }
1949: CJSON_PUBLIC(cJSON *) cJSON_CreateObject(void)
1950: {
1951: cJSON *item = cJSON_New_Item(&global_hooks);
1952: if (item) { item->type = cJSON_Object; }
1954: return item;
1955: }
1957: /* Create Arrays: */
1958: CJSON_PUBLIC(cJSON *) cJSON_CreateIntArray(const int *numbers, int count)
1959: {
1960: size_t i = 0;
1961: cJSON *n = NULL;
1962: cJSON *p = NULL;
1963: cJSON *a = NULL;
1965: if ((count < 0) || (numbers == NULL)) { return NULL; }
1967: a = cJSON_CreateArray();
1969: for (i = 0; a && (i < (size_t)count); i++) {
1970: n = cJSON_CreateNumber(numbers[i]);
1971: if (!n) {
1972: cJSON_Delete(a);
1973: return NULL;
1974: }
1975: if (!i) {
1976: a->child = n;
1977: } else {
1978: suffix_object(p, n);
1979: }
1980: p = n;
1981: }
1983: if (a && a->child) { a->child->prev = n; }
1985: return a;
1986: }
1988: CJSON_PUBLIC(cJSON *) cJSON_CreateFloatArray(const float *numbers, int count)
1989: {
1990: size_t i = 0;
1991: cJSON *n = NULL;
1992: cJSON *p = NULL;
1993: cJSON *a = NULL;
1995: if ((count < 0) || (numbers == NULL)) { return NULL; }
1997: a = cJSON_CreateArray();
1999: for (i = 0; a && (i < (size_t)count); i++) {
2000: n = cJSON_CreateNumber((double)numbers[i]);
2001: if (!n) {
2002: cJSON_Delete(a);
2003: return NULL;
2004: }
2005: if (!i) {
2006: a->child = n;
2007: } else {
2008: suffix_object(p, n);
2009: }
2010: p = n;
2011: }
2013: if (a && a->child) { a->child->prev = n; }
2015: return a;
2016: }
2018: CJSON_PUBLIC(cJSON *) cJSON_CreateDoubleArray(const double *numbers, int count)
2019: {
2020: size_t i = 0;
2021: cJSON *n = NULL;
2022: cJSON *p = NULL;
2023: cJSON *a = NULL;
2025: if ((count < 0) || (numbers == NULL)) { return NULL; }
2027: a = cJSON_CreateArray();
2029: for (i = 0; a && (i < (size_t)count); i++) {
2030: n = cJSON_CreateNumber(numbers[i]);
2031: if (!n) {
2032: cJSON_Delete(a);
2033: return NULL;
2034: }
2035: if (!i) {
2036: a->child = n;
2037: } else {
2038: suffix_object(p, n);
2039: }
2040: p = n;
2041: }
2043: if (a && a->child) { a->child->prev = n; }
2045: return a;
2046: }
2048: CJSON_PUBLIC(cJSON *) cJSON_CreateStringArray(const char *const *strings, int count)
2049: {
2050: size_t i = 0;
2051: cJSON *n = NULL;
2052: cJSON *p = NULL;
2053: cJSON *a = NULL;
2055: if ((count < 0) || (strings == NULL)) { return NULL; }
2057: a = cJSON_CreateArray();
2059: for (i = 0; a && (i < (size_t)count); i++) {
2060: n = cJSON_CreateString(strings[i]);
2061: if (!n) {
2062: cJSON_Delete(a);
2063: return NULL;
2064: }
2065: if (!i) {
2066: a->child = n;
2067: } else {
2068: suffix_object(p, n);
2069: }
2070: p = n;
2071: }
2073: if (a && a->child) { a->child->prev = n; }
2075: return a;
2076: }
2078: /* Duplication */
2079: CJSON_PUBLIC(cJSON *) cJSON_Duplicate(const cJSON *item, cJSON_bool recurse)
2080: {
2081: cJSON *newitem = NULL;
2082: cJSON *child = NULL;
2083: cJSON *next = NULL;
2084: cJSON *newchild = NULL;
2086: /* Bail on bad ptr */
2087: if (!item) { goto fail; }
2088: /* Create new item */
2089: newitem = cJSON_New_Item(&global_hooks);
2090: if (!newitem) { goto fail; }
2091: /* Copy over all vars */
2092: newitem->type = item->type & (~cJSON_IsReference);
2093: newitem->valueint = item->valueint;
2094: newitem->valuedouble = item->valuedouble;
2095: if (item->valuestring) {
2096: newitem->valuestring = (char *)cJSON_strdup((unsigned char *)item->valuestring, &global_hooks);
2097: if (!newitem->valuestring) { goto fail; }
2098: }
2099: if (item->string) {
2100: newitem->string = (item->type & cJSON_StringIsConst) ? item->string : (char *)cJSON_strdup((unsigned char *)item->string, &global_hooks);
2101: if (!newitem->string) { goto fail; }
2102: }
2103: /* If non-recursive, then we're done! */
2104: if (!recurse) { return newitem; }
2105: /* Walk the ->next chain for the child. */
2106: child = item->child;
2107: while (child != NULL) {
2108: newchild = cJSON_Duplicate(child, true); /* Duplicate (with recurse) each item in the ->next chain */
2109: if (!newchild) { goto fail; }
2110: if (next != NULL) {
2111: /* If newitem->child already set, then crosswire ->prev and ->next and move on */
2112: next->next = newchild;
2113: newchild->prev = next;
2114: next = newchild;
2115: } else {
2116: /* Set newitem->child and move to it */
2117: newitem->child = newchild;
2118: next = newchild;
2119: }
2120: child = child->next;
2121: }
2122: if (newitem && newitem->child) { newitem->child->prev = newchild; }
2124: return newitem;
2126: fail:
2127: if (newitem != NULL) { cJSON_Delete(newitem); }
2129: return NULL;
2130: }
2132: static void skip_oneline_comment(char **input)
2133: {
2134: *input += static_strlen("//");
2136: for (; (*input)[0] != '\0'; ++(*input)) {
2137: if ((*input)[0] == '\n') {
2138: *input += static_strlen("\n");
2139: return;
2140: }
2141: }
2142: }
2144: static void skip_multiline_comment(char **input)
2145: {
2146: *input += static_strlen("/*");
2148: for (; (*input)[0] != '\0'; ++(*input)) {
2149: if (((*input)[0] == '*') && ((*input)[1] == '/')) {
2150: *input += static_strlen("*/");
2151: return;
2152: }
2153: }
2154: }
2156: static void minify_string(char **input, char **output)
2157: {
2158: (*output)[0] = (*input)[0];
2159: *input += static_strlen("\"");
2160: *output += static_strlen("\"");
2162: for (; (*input)[0] != '\0'; (void)++(*input), ++(*output)) {
2163: (*output)[0] = (*input)[0];
2165: if ((*input)[0] == '\"') {
2166: (*output)[0] = '\"';
2167: *input += static_strlen("\"");
2168: *output += static_strlen("\"");
2169: return;
2170: } else if (((*input)[0] == '\\') && ((*input)[1] == '\"')) {
2171: (*output)[1] = (*input)[1];
2172: *input += static_strlen("\"");
2173: *output += static_strlen("\"");
2174: }
2175: }
2176: }
2178: CJSON_PUBLIC(void) cJSON_Minify(char *json)
2179: {
2180: char *into = json;
2182: if (json == NULL) { return; }
2184: while (json[0] != '\0') {
2185: switch (json[0]) {
2186: case ' ':
2187: case '\t':
2188: case '\r':
2189: case '\n':
2190: json++;
2191: break;
2193: case '/':
2194: if (json[1] == '/') {
2195: skip_oneline_comment(&json);
2196: } else if (json[1] == '*') {
2197: skip_multiline_comment(&json);
2198: } else {
2199: json++;
2200: }
2201: break;
2203: case '\"':
2204: minify_string(&json, (char **)&into);
2205: break;
2207: default:
2208: into[0] = json[0];
2209: json++;
2210: into++;
2211: }
2212: }
2214: /* and null-terminate. */
2215: *into = '\0';
2216: }
2218: CJSON_PUBLIC(cJSON_bool) cJSON_IsInvalid(const cJSON *const item)
2219: {
2220: if (item == NULL) { return false; }
2222: return (item->type & 0xFF) == cJSON_Invalid;
2223: }
2225: CJSON_PUBLIC(cJSON_bool) cJSON_IsFalse(const cJSON *const item)
2226: {
2227: if (item == NULL) { return false; }
2229: return (item->type & 0xFF) == cJSON_False;
2230: }
2232: CJSON_PUBLIC(cJSON_bool) cJSON_IsTrue(const cJSON *const item)
2233: {
2234: if (item == NULL) { return false; }
2236: return (item->type & 0xff) == cJSON_True;
2237: }
2239: CJSON_PUBLIC(cJSON_bool) cJSON_IsBool(const cJSON *const item)
2240: {
2241: if (item == NULL) { return false; }
2243: return (item->type & (cJSON_True | cJSON_False)) != 0;
2244: }
2245: CJSON_PUBLIC(cJSON_bool) cJSON_IsNull(const cJSON *const item)
2246: {
2247: if (item == NULL) { return false; }
2249: return (item->type & 0xFF) == cJSON_NULL;
2250: }
2252: CJSON_PUBLIC(cJSON_bool) cJSON_IsNumber(const cJSON *const item)
2253: {
2254: if (item == NULL) { return false; }
2256: return (item->type & 0xFF) == cJSON_Number;
2257: }
2259: CJSON_PUBLIC(cJSON_bool) cJSON_IsString(const cJSON *const item)
2260: {
2261: if (item == NULL) { return false; }
2263: return (item->type & 0xFF) == cJSON_String;
2264: }
2266: CJSON_PUBLIC(cJSON_bool) cJSON_IsArray(const cJSON *const item)
2267: {
2268: if (item == NULL) { return false; }
2270: return (item->type & 0xFF) == cJSON_Array;
2271: }
2273: CJSON_PUBLIC(cJSON_bool) cJSON_IsObject(const cJSON *const item)
2274: {
2275: if (item == NULL) { return false; }
2277: return (item->type & 0xFF) == cJSON_Object;
2278: }
2280: CJSON_PUBLIC(cJSON_bool) cJSON_IsRaw(const cJSON *const item)
2281: {
2282: if (item == NULL) { return false; }
2284: return (item->type & 0xFF) == cJSON_Raw;
2285: }
2287: CJSON_PUBLIC(cJSON_bool) cJSON_Compare(const cJSON *const a, const cJSON *const b, const cJSON_bool case_sensitive)
2288: {
2289: if ((a == NULL) || (b == NULL) || ((a->type & 0xFF) != (b->type & 0xFF))) { return false; }
2291: /* check if type is valid */
2292: switch (a->type & 0xFF) {
2293: case cJSON_False:
2294: case cJSON_True:
2295: case cJSON_NULL:
2296: case cJSON_Number:
2297: case cJSON_String:
2298: case cJSON_Raw:
2299: case cJSON_Array:
2300: case cJSON_Object:
2301: break;
2303: default:
2304: return false;
2305: }
2307: /* identical objects are equal */
2308: if (a == b) { return true; }
2310: switch (a->type & 0xFF) {
2311: /* in these cases and equal type is enough */
2312: case cJSON_False:
2313: case cJSON_True:
2314: case cJSON_NULL:
2315: return true;
2317: case cJSON_Number:
2318: if (compare_double(a->valuedouble, b->valuedouble)) { return true; }
2319: return false;
2321: case cJSON_String:
2322: case cJSON_Raw:
2323: if ((a->valuestring == NULL) || (b->valuestring == NULL)) { return false; }
2324: if (strcmp(a->valuestring, b->valuestring) == 0) { return true; }
2326: return false;
2328: case cJSON_Array: {
2329: cJSON *a_element = a->child;
2330: cJSON *b_element = b->child;
2332: for (; (a_element != NULL) && (b_element != NULL);) {
2333: if (!cJSON_Compare(a_element, b_element, case_sensitive)) { return false; }
2335: a_element = a_element->next;
2336: b_element = b_element->next;
2337: }
2339: /* one of the arrays is longer than the other */
2340: if (a_element != b_element) { return false; }
2342: return true;
2343: }
2345: case cJSON_Object: {
2346: cJSON *a_element = NULL;
2347: cJSON *b_element = NULL;
2348: cJSON_ArrayForEach(a_element, a)
2349: {
2350: /* TODO This has O(n^2) runtime, which is horrible! */
2351: b_element = get_object_item(b, a_element->string, case_sensitive);
2352: if (b_element == NULL) { return false; }
2354: if (!cJSON_Compare(a_element, b_element, case_sensitive)) { return false; }
2355: }
2357: /* doing this twice, once on a and b to prevent true comparison if a subset of b
2358: * TODO: Do this the proper way, this is just a fix for now */
2359: cJSON_ArrayForEach(b_element, b)
2360: {
2361: a_element = get_object_item(a, b_element->string, case_sensitive);
2362: if (a_element == NULL) { return false; }
2364: if (!cJSON_Compare(b_element, a_element, case_sensitive)) { return false; }
2365: }
2367: return true;
2368: }
2370: default:
2371: return false;
2372: }
2373: }
2375: CJSON_PUBLIC(void *) cJSON_malloc(size_t size)
2376: {
2377: return global_hooks.allocate(size);
2378: }
2380: CJSON_PUBLIC(void) cJSON_free(void *object)
2381: {
2382: global_hooks.deallocate(object);
2383: }