cJSON.c 65.8 KB
Newer Older
K
Kevin Branigan 已提交
1
/*
M
Max Bruckner 已提交
2
  Copyright (c) 2009-2017 Dave Gamble and cJSON contributors
K
Kevin Branigan 已提交
3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25

  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. */

26
#ifdef __GNUC__
27
#pragma GCC visibility push(default)
28 29
#endif

K
Kevin Branigan 已提交
30 31 32 33 34 35 36
#include <string.h>
#include <stdio.h>
#include <math.h>
#include <stdlib.h>
#include <float.h>
#include <limits.h>
#include <ctype.h>
37
#include <locale.h>
38 39

#ifdef __GNUC__
40
#pragma GCC visibility pop
41
#endif
42

K
Kevin Branigan 已提交
43 44
#include "cJSON.h"

M
Max Bruckner 已提交
45
/* define our own boolean type */
46 47
#define true ((cJSON_bool)1)
#define false ((cJSON_bool)0)
M
Max Bruckner 已提交
48

49 50 51 52 53
typedef struct {
    const unsigned char *json;
    size_t position;
} error;
static error global_error = { NULL, 0 };
K
Kevin Branigan 已提交
54

55
CJSON_PUBLIC(const char *) cJSON_GetErrorPtr(void)
M
Max Bruckner 已提交
56
{
57
    return (const char*) (global_error.json + global_error.position);
M
Max Bruckner 已提交
58
}
K
Kevin Branigan 已提交
59

60
/* This is a safeguard to prevent copy-pasters from using incompatible C and header files */
M
Max Bruckner 已提交
61
#if (CJSON_VERSION_MAJOR != 1) || (CJSON_VERSION_MINOR != 5) || (CJSON_VERSION_PATCH != 9)
62 63 64
    #error cJSON.h and cJSON.c have different versions. Make sure that both have the same.
#endif

65
CJSON_PUBLIC(const char*) cJSON_Version(void)
66 67 68 69 70 71 72
{
    static char version[15];
    sprintf(version, "%i.%i.%i", CJSON_VERSION_MAJOR, CJSON_VERSION_MINOR, CJSON_VERSION_PATCH);

    return version;
}

73 74
/* Case insensitive string comparison, doesn't consider two NULL pointers equal though */
static int case_insensitive_strcmp(const unsigned char *string1, const unsigned char *string2)
K
Kevin Branigan 已提交
75
{
76
    if ((string1 == NULL) || (string2 == NULL))
M
Max Bruckner 已提交
77
    {
78
        return 1;
M
Max Bruckner 已提交
79
    }
80

81
    if (string1 == string2)
M
Max Bruckner 已提交
82
    {
83
        return 0;
M
Max Bruckner 已提交
84
    }
85 86

    for(; tolower(*string1) == tolower(*string2); (void)string1++, string2++)
M
Max Bruckner 已提交
87
    {
88
        if (*string1 == '\0')
M
Max Bruckner 已提交
89 90 91 92 93
        {
            return 0;
        }
    }

94
    return tolower(*string1) - tolower(*string2);
K
Kevin Branigan 已提交
95 96
}

97 98 99 100 101 102 103 104
typedef struct internal_hooks
{
    void *(*allocate)(size_t size);
    void (*deallocate)(void *pointer);
    void *(*reallocate)(void *pointer, size_t size);
} internal_hooks;

static internal_hooks global_hooks = { malloc, free, realloc };
K
Kevin Branigan 已提交
105

M
Max Bruckner 已提交
106
static unsigned char* cJSON_strdup(const unsigned char* string, const internal_hooks * const hooks)
K
Kevin Branigan 已提交
107
{
M
Max Bruckner 已提交
108
    size_t length = 0;
109
    unsigned char *copy = NULL;
K
Kevin Branigan 已提交
110

M
Max Bruckner 已提交
111
    if (string == NULL)
112 113 114 115
    {
        return NULL;
    }

M
Max Bruckner 已提交
116 117
    length = strlen((const char*)string) + sizeof("");
    if (!(copy = (unsigned char*)hooks->allocate(length)))
M
Max Bruckner 已提交
118
    {
119
        return NULL;
M
Max Bruckner 已提交
120
    }
M
Max Bruckner 已提交
121
    memcpy(copy, string, length);
M
Max Bruckner 已提交
122 123

    return copy;
K
Kevin Branigan 已提交
124 125
}

126
CJSON_PUBLIC(void) cJSON_InitHooks(cJSON_Hooks* hooks)
K
Kevin Branigan 已提交
127
{
M
Max Bruckner 已提交
128
    if (hooks == NULL)
M
Max Bruckner 已提交
129 130
    {
        /* Reset hooks */
131 132 133
        global_hooks.allocate = malloc;
        global_hooks.deallocate = free;
        global_hooks.reallocate = realloc;
K
Kevin Branigan 已提交
134 135 136
        return;
    }

137
    global_hooks.allocate = malloc;
M
Max Bruckner 已提交
138 139
    if (hooks->malloc_fn != NULL)
    {
140
        global_hooks.allocate = hooks->malloc_fn;
M
Max Bruckner 已提交
141 142
    }

143
    global_hooks.deallocate = free;
M
Max Bruckner 已提交
144 145
    if (hooks->free_fn != NULL)
    {
146
        global_hooks.deallocate = hooks->free_fn;
M
Max Bruckner 已提交
147 148 149
    }

    /* use realloc only if both free and malloc are used */
150 151
    global_hooks.reallocate = NULL;
    if ((global_hooks.allocate == malloc) && (global_hooks.deallocate == free))
M
Max Bruckner 已提交
152
    {
153
        global_hooks.reallocate = realloc;
M
Max Bruckner 已提交
154
    }
K
Kevin Branigan 已提交
155 156 157
}

/* Internal constructor. */
158
static cJSON *cJSON_New_Item(const internal_hooks * const hooks)
K
Kevin Branigan 已提交
159
{
160
    cJSON* node = (cJSON*)hooks->allocate(sizeof(cJSON));
M
Max Bruckner 已提交
161 162
    if (node)
    {
163
        memset(node, '\0', sizeof(cJSON));
M
Max Bruckner 已提交
164 165 166
    }

    return node;
K
Kevin Branigan 已提交
167 168 169
}

/* Delete a cJSON structure. */
M
Max Bruckner 已提交
170
CJSON_PUBLIC(void) cJSON_Delete(cJSON *item)
K
Kevin Branigan 已提交
171
{
M
Max Bruckner 已提交
172
    cJSON *next = NULL;
M
Max Bruckner 已提交
173
    while (item != NULL)
M
Max Bruckner 已提交
174
    {
M
Max Bruckner 已提交
175 176
        next = item->next;
        if (!(item->type & cJSON_IsReference) && (item->child != NULL))
M
Max Bruckner 已提交
177
        {
M
Max Bruckner 已提交
178
            cJSON_Delete(item->child);
M
Max Bruckner 已提交
179
        }
M
Max Bruckner 已提交
180
        if (!(item->type & cJSON_IsReference) && (item->valuestring != NULL))
M
Max Bruckner 已提交
181
        {
M
Max Bruckner 已提交
182
            global_hooks.deallocate(item->valuestring);
M
Max Bruckner 已提交
183
        }
M
Max Bruckner 已提交
184
        if (!(item->type & cJSON_StringIsConst) && (item->string != NULL))
M
Max Bruckner 已提交
185
        {
M
Max Bruckner 已提交
186
            global_hooks.deallocate(item->string);
M
Max Bruckner 已提交
187
        }
M
Max Bruckner 已提交
188 189
        global_hooks.deallocate(item);
        item = next;
M
Max Bruckner 已提交
190
    }
K
Kevin Branigan 已提交
191 192
}

193 194 195
/* get the decimal point character of the current locale */
static unsigned char get_decimal_point(void)
{
196
#ifdef ENABLE_LOCALES
197 198
    struct lconv *lconv = localeconv();
    return (unsigned char) lconv->decimal_point[0];
199 200 201
#else
	return '.';
#endif
202 203
}

M
Max Bruckner 已提交
204 205 206 207 208
typedef struct
{
    const unsigned char *content;
    size_t length;
    size_t offset;
209
    size_t depth; /* How deeply nested (in arrays/objects) is the input at the current offset. */
210
    internal_hooks hooks;
M
Max Bruckner 已提交
211 212 213 214 215 216 217 218 219 220 221
} parse_buffer;

/* check if the given size is left to read in a given parse buffer (starting with 1) */
#define can_read(buffer, size) ((buffer != NULL) && (((buffer)->offset + size) <= (buffer)->length))
#define cannot_read(buffer, size) (!can_read(buffer, size))
/* check if the buffer can be accessed at the given index (starting with 0) */
#define can_access_at_index(buffer, index) ((buffer != NULL) && (((buffer)->offset + index) < (buffer)->length))
#define cannot_access_at_index(buffer, index) (!can_access_at_index(buffer, index))
/* get a pointer to the buffer at the position */
#define buffer_at_offset(buffer) ((buffer)->content + (buffer)->offset)

K
Kevin Branigan 已提交
222
/* Parse the input text to generate a number, and populate the result into item. */
223
static cJSON_bool parse_number(cJSON * const item, parse_buffer * const input_buffer)
K
Kevin Branigan 已提交
224
{
225
    double number = 0;
226
    unsigned char *after_end = NULL;
227 228 229
    unsigned char number_c_string[64];
    unsigned char decimal_point = get_decimal_point();
    size_t i = 0;
M
Max Bruckner 已提交
230

M
Max Bruckner 已提交
231
    if ((input_buffer == NULL) || (input_buffer->content == NULL))
232
    {
233
        return false;
234 235
    }

236
    /* copy the number into a temporary buffer and replace '.' with the decimal point
M
Max Bruckner 已提交
237 238 239
     * of the current locale (for strtod)
     * This also takes care of '\0' not necessarily being available for marking the end of the input */
    for (i = 0; (i < (sizeof(number_c_string) - 1)) && can_access_at_index(input_buffer, i); i++)
240
    {
M
Max Bruckner 已提交
241
        switch (buffer_at_offset(input_buffer)[i])
242 243 244 245 246 247 248 249 250 251 252 253 254 255 256
        {
            case '0':
            case '1':
            case '2':
            case '3':
            case '4':
            case '5':
            case '6':
            case '7':
            case '8':
            case '9':
            case '+':
            case '-':
            case 'e':
            case 'E':
M
Max Bruckner 已提交
257
                number_c_string[i] = buffer_at_offset(input_buffer)[i];
258 259 260 261 262 263 264 265 266 267 268 269 270 271 272
                break;

            case '.':
                number_c_string[i] = decimal_point;
                break;

            default:
                goto loop_end;
        }
    }
loop_end:
    number_c_string[i] = '\0';

    number = strtod((const char*)number_c_string, (char**)&after_end);
    if (number_c_string == after_end)
M
Max Bruckner 已提交
273
    {
274
        return false; /* parse_error */
M
Max Bruckner 已提交
275 276
    }

277
    item->valuedouble = number;
M
Max Bruckner 已提交
278

279
    /* use saturation in case of overflow */
280
    if (number >= INT_MAX)
281 282 283
    {
        item->valueint = INT_MAX;
    }
284
    else if (number <= INT_MIN)
285 286 287 288 289
    {
        item->valueint = INT_MIN;
    }
    else
    {
290
        item->valueint = (int)number;
291
    }
292

M
Max Bruckner 已提交
293 294
    item->type = cJSON_Number;

M
Max Bruckner 已提交
295
    input_buffer->offset += (size_t)(after_end - number_c_string);
296
    return true;
K
Kevin Branigan 已提交
297 298
}

299
/* don't ask me, but the original cJSON_SetNumberValue returns an integer or double */
300
CJSON_PUBLIC(double) cJSON_SetNumberHelper(cJSON *object, double number)
301 302 303 304 305 306 307 308 309 310 311
{
    if (number >= INT_MAX)
    {
        object->valueint = INT_MAX;
    }
    else if (number <= INT_MIN)
    {
        object->valueint = INT_MIN;
    }
    else
    {
312
        object->valueint = (int)number;
313 314 315 316 317
    }

    return object->valuedouble = number;
}

M
Max Bruckner 已提交
318 319
typedef struct
{
320
    unsigned char *buffer;
321 322
    size_t length;
    size_t offset;
M
Max Bruckner 已提交
323
    size_t depth; /* current nesting depth (for formatted printing) */
324
    cJSON_bool noalloc;
M
Max Bruckner 已提交
325
    cJSON_bool format; /* is this print a formatted print */
326
    internal_hooks hooks;
M
Max Bruckner 已提交
327
} printbuffer;
328

M
Max Bruckner 已提交
329
/* realloc printbuffer if necessary to have at least "needed" bytes more */
330
static unsigned char* ensure(printbuffer * const p, size_t needed)
331
{
332
    unsigned char *newbuffer = NULL;
333 334
    size_t newsize = 0;

335
    if ((p == NULL) || (p->buffer == NULL))
336 337 338 339
    {
        return NULL;
    }

M
Max Bruckner 已提交
340 341 342 343 344 345
    if ((p->length > 0) && (p->offset >= p->length))
    {
        /* make sure that offset is valid */
        return NULL;
    }

346
    if (needed > INT_MAX)
M
Max Bruckner 已提交
347
    {
348
        /* sizes bigger than INT_MAX are currently not supported */
349
        return NULL;
M
Max Bruckner 已提交
350
    }
351

352
    needed += p->offset + 1;
M
Max Bruckner 已提交
353 354 355 356 357
    if (needed <= p->length)
    {
        return p->buffer + p->offset;
    }

358 359 360 361
    if (p->noalloc) {
        return NULL;
    }

362
    /* calculate new buffer size */
M
Max Bruckner 已提交
363
    if (needed > (INT_MAX / 2))
364 365 366 367 368 369 370 371 372 373 374
    {
        /* overflow of int, use INT_MAX if possible */
        if (needed <= INT_MAX)
        {
            newsize = INT_MAX;
        }
        else
        {
            return NULL;
        }
    }
375 376 377 378
    else
    {
        newsize = needed * 2;
    }
379

380
    if (p->hooks.reallocate != NULL)
M
Max Bruckner 已提交
381
    {
M
Max Bruckner 已提交
382
        /* reallocate with realloc if available */
383
        newbuffer = (unsigned char*)p->hooks.reallocate(p->buffer, newsize);
384 385 386 387 388 389 390 391
        if (newbuffer == NULL)
        {
            p->hooks.deallocate(p->buffer);
            p->length = 0;
            p->buffer = NULL;

            return NULL;
        }
M
Max Bruckner 已提交
392
    }
M
Max Bruckner 已提交
393
    else
M
Max Bruckner 已提交
394
    {
M
Max Bruckner 已提交
395
        /* otherwise reallocate manually */
396
        newbuffer = (unsigned char*)p->hooks.allocate(newsize);
M
Max Bruckner 已提交
397 398
        if (!newbuffer)
        {
399
            p->hooks.deallocate(p->buffer);
M
Max Bruckner 已提交
400 401 402 403 404 405 406
            p->length = 0;
            p->buffer = NULL;

            return NULL;
        }
        if (newbuffer)
        {
407
            memcpy(newbuffer, p->buffer, p->offset + 1);
M
Max Bruckner 已提交
408
        }
409
        p->hooks.deallocate(p->buffer);
M
Max Bruckner 已提交
410 411 412 413 414
    }
    p->length = newsize;
    p->buffer = newbuffer;

    return newbuffer + p->offset;
415 416
}

417 418
/* calculate the new length of the string in a printbuffer and update the offset */
static void update_offset(printbuffer * const buffer)
K
Kevin Branigan 已提交
419
{
420 421
    const unsigned char *buffer_pointer = NULL;
    if ((buffer == NULL) || (buffer->buffer == NULL))
M
Max Bruckner 已提交
422
    {
423
        return;
M
Max Bruckner 已提交
424
    }
425
    buffer_pointer = buffer->buffer + buffer->offset;
M
Max Bruckner 已提交
426

427
    buffer->offset += strlen((const char*)buffer_pointer);
428 429 430
}

/* Render the number nicely from the given item into a string. */
431
static cJSON_bool print_number(const cJSON * const item, printbuffer * const output_buffer)
432
{
M
Max Bruckner 已提交
433
    unsigned char *output_pointer = NULL;
M
Max Bruckner 已提交
434
    double d = item->valuedouble;
435
    int length = 0;
436
    size_t i = 0;
437
    unsigned char number_buffer[26]; /* temporary buffer to print the number into */
438
    unsigned char decimal_point = get_decimal_point();
439
    double test;
M
Max Bruckner 已提交
440

M
Max Bruckner 已提交
441
    if (output_buffer == NULL)
M
Max Bruckner 已提交
442
    {
443
        return false;
M
Max Bruckner 已提交
444
    }
M
Max Bruckner 已提交
445

446 447 448
    /* This checks for NaN and Infinity */
    if ((d * 0) != 0)
    {
449
        length = sprintf((char*)number_buffer, "null");
450 451 452
    }
    else
    {
453 454 455 456 457 458 459 460 461
        /* Try 15 decimal places of precision to avoid nonsignificant nonzero digits */
        length = sprintf((char*)number_buffer, "%1.15g", d);

        /* Check whether the original double can be recovered */
        if ((sscanf((char*)number_buffer, "%lg", &test) != 1) || ((double)test != d))
        {
            /* If not, print with 17 decimal places of precision */
            length = sprintf((char*)number_buffer, "%1.17g", d);
        }
M
Max Bruckner 已提交
462
    }
463

464 465
    /* sprintf failed or buffer overrun occured */
    if ((length < 0) || (length > (int)(sizeof(number_buffer) - 1)))
466
    {
467
        return false;
468 469
    }

470
    /* reserve appropriate space in the output */
471
    output_pointer = ensure(output_buffer, (size_t)length);
472 473 474
    if (output_pointer == NULL)
    {
        return false;
475 476
    }

477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492
    /* copy the printed number to the output and replace locale
     * dependent decimal point with '.' */
    for (i = 0; i < ((size_t)length); i++)
    {
        if (number_buffer[i] == decimal_point)
        {
            output_pointer[i] = '.';
            continue;
        }

        output_pointer[i] = number_buffer[i];
    }
    output_pointer[i] = '\0';

    output_buffer->offset += (size_t)length;

493
    return true;
K
Kevin Branigan 已提交
494 495
}

M
Max Bruckner 已提交
496
/* parse 4 digit hexadecimal number */
497
static unsigned parse_hex4(const unsigned char * const input)
498
{
M
Max Bruckner 已提交
499
    unsigned int h = 0;
500
    size_t i = 0;
M
Max Bruckner 已提交
501

502
    for (i = 0; i < 4; i++)
M
Max Bruckner 已提交
503
    {
504
        /* parse digit */
505
        if ((input[i] >= '0') && (input[i] <= '9'))
506
        {
507
            h += (unsigned int) input[i] - '0';
508
        }
509
        else if ((input[i] >= 'A') && (input[i] <= 'F'))
510
        {
511
            h += (unsigned int) 10 + input[i] - 'A';
512
        }
513
        else if ((input[i] >= 'a') && (input[i] <= 'f'))
514
        {
515
            h += (unsigned int) 10 + input[i] - 'a';
516 517 518 519 520
        }
        else /* invalid */
        {
            return 0;
        }
M
Max Bruckner 已提交
521

522 523 524 525 526
        if (i < 3)
        {
            /* shift left to make place for the next nibble */
            h = h << 4;
        }
M
Max Bruckner 已提交
527 528 529
    }

    return h;
530 531
}

532 533
/* converts a UTF-16 literal to UTF-8
 * A literal can be one or two sequences of the form \uXXXX */
534
static unsigned char utf16_literal_to_utf8(const unsigned char * const input_pointer, const unsigned char * const input_end, unsigned char **output_pointer)
M
Max Bruckner 已提交
535
{
536 537 538
    long unsigned int codepoint = 0;
    unsigned int first_code = 0;
    const unsigned char *first_sequence = input_pointer;
539
    unsigned char utf8_length = 0;
540
    unsigned char utf8_position = 0;
541
    unsigned char sequence_length = 0;
542
    unsigned char first_byte_mark = 0;
543 544 545 546 547 548

    if ((input_end - first_sequence) < 6)
    {
        /* input ends unexpectedly */
        goto fail;
    }
M
Max Bruckner 已提交
549

550 551 552
    /* get the first utf16 sequence */
    first_code = parse_hex4(first_sequence + 2);

553
    /* check that the code is valid */
554
    if (((first_code >= 0xDC00) && (first_code <= 0xDFFF)))
M
Max Bruckner 已提交
555
    {
556
        goto fail;
M
Max Bruckner 已提交
557
    }
M
Max Bruckner 已提交
558

559 560
    /* UTF16 surrogate pair */
    if ((first_code >= 0xD800) && (first_code <= 0xDBFF))
M
Max Bruckner 已提交
561
    {
562 563 564 565 566
        const unsigned char *second_sequence = first_sequence + 6;
        unsigned int second_code = 0;
        sequence_length = 12; /* \uXXXX\uXXXX */

        if ((input_end - second_sequence) < 6)
M
Max Bruckner 已提交
567
        {
568 569
            /* input ends unexpectedly */
            goto fail;
M
Max Bruckner 已提交
570
        }
571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594

        if ((second_sequence[0] != '\\') || (second_sequence[1] != 'u'))
        {
            /* missing second half of the surrogate pair */
            goto fail;
        }

        /* get the second utf16 sequence */
        second_code = parse_hex4(second_sequence + 2);
        /* check that the code is valid */
        if ((second_code < 0xDC00) || (second_code > 0xDFFF))
        {
            /* invalid second half of the surrogate pair */
            goto fail;
        }


        /* calculate the unicode codepoint from the surrogate pair */
        codepoint = 0x10000 + (((first_code & 0x3FF) << 10) | (second_code & 0x3FF));
    }
    else
    {
        sequence_length = 6; /* \uXXXX */
        codepoint = first_code;
M
Max Bruckner 已提交
595
    }
M
Max Bruckner 已提交
596

597 598 599 600 601 602 603 604 605 606 607 608
    /* encode as UTF-8
     * takes at maximum 4 bytes to encode:
     * 11110xxx 10xxxxxx 10xxxxxx 10xxxxxx */
    if (codepoint < 0x80)
    {
        /* normal ascii, encoding 0xxxxxxx */
        utf8_length = 1;
    }
    else if (codepoint < 0x800)
    {
        /* two bytes, encoding 110xxxxx 10xxxxxx */
        utf8_length = 2;
609
        first_byte_mark = 0xC0; /* 11000000 */
610 611 612 613 614
    }
    else if (codepoint < 0x10000)
    {
        /* three bytes, encoding 1110xxxx 10xxxxxx 10xxxxxx */
        utf8_length = 3;
615
        first_byte_mark = 0xE0; /* 11100000 */
616 617 618 619 620
    }
    else if (codepoint <= 0x10FFFF)
    {
        /* four bytes, encoding 1110xxxx 10xxxxxx 10xxxxxx 10xxxxxx */
        utf8_length = 4;
621
        first_byte_mark = 0xF0; /* 11110000 */
622 623
    }
    else
M
Max Bruckner 已提交
624
    {
625
        /* invalid unicode codepoint */
626
        goto fail;
M
Max Bruckner 已提交
627 628
    }

629
    /* encode as utf8 */
630 631 632 633 634
    for (utf8_position = (unsigned char)(utf8_length - 1); utf8_position > 0; utf8_position--)
    {
        /* 10xxxxxx */
        (*output_pointer)[utf8_position] = (unsigned char)((codepoint | 0x80) & 0xBF);
        codepoint >>= 6;
635
    }
636 637 638 639 640 641 642 643
    /* encode first byte */
    if (utf8_length > 1)
    {
        (*output_pointer)[0] = (unsigned char)((codepoint | first_byte_mark) & 0xFF);
    }
    else
    {
        (*output_pointer)[0] = (unsigned char)(codepoint & 0x7F);
644
    }
645

646 647 648 649 650 651 652 653 654
    *output_pointer += utf8_length;

    return sequence_length;

fail:
    return 0;
}

/* Parse the input text into an unescaped cinput, and populate item. */
655
static cJSON_bool parse_string(cJSON * const item, parse_buffer * const input_buffer)
656
{
M
Max Bruckner 已提交
657 658
    const unsigned char *input_pointer = buffer_at_offset(input_buffer) + 1;
    const unsigned char *input_end = buffer_at_offset(input_buffer) + 1;
659 660 661 662
    unsigned char *output_pointer = NULL;
    unsigned char *output = NULL;

    /* not a string */
M
Max Bruckner 已提交
663
    if (buffer_at_offset(input_buffer)[0] != '\"')
664 665 666 667 668 669 670 671
    {
        goto fail;
    }

    {
        /* calculate approximate size of the output (overestimate) */
        size_t allocation_length = 0;
        size_t skipped_bytes = 0;
672
        while (((size_t)(input_end - input_buffer->content) < input_buffer->length) && (*input_end != '\"'))
673 674 675 676
        {
            /* is escape sequence */
            if (input_end[0] == '\\')
            {
M
Max Bruckner 已提交
677
                if ((size_t)(input_end + 1 - input_buffer->content) >= input_buffer->length)
678 679 680 681 682 683 684 685 686
                {
                    /* prevent buffer overflow when last input character is a backslash */
                    goto fail;
                }
                skipped_bytes++;
                input_end++;
            }
            input_end++;
        }
687
        if (((size_t)(input_end - input_buffer->content) >= input_buffer->length) || (*input_end != '\"'))
688 689 690 691 692
        {
            goto fail; /* string ended unexpectedly */
        }

        /* This is at most how much we need for the output */
M
Max Bruckner 已提交
693
        allocation_length = (size_t) (input_end - buffer_at_offset(input_buffer)) - skipped_bytes;
694
        output = (unsigned char*)input_buffer->hooks.allocate(allocation_length + sizeof(""));
695 696 697 698 699 700 701
        if (output == NULL)
        {
            goto fail; /* allocation failure */
        }
    }

    output_pointer = output;
M
Max Bruckner 已提交
702
    /* loop through the string literal */
703
    while (input_pointer < input_end)
M
Max Bruckner 已提交
704
    {
705
        if (*input_pointer != '\\')
M
Max Bruckner 已提交
706
        {
707
            *output_pointer++ = *input_pointer++;
M
Max Bruckner 已提交
708 709 710 711
        }
        /* escape sequence */
        else
        {
712
            unsigned char sequence_length = 2;
M
Max Bruckner 已提交
713 714 715 716 717
            if ((input_end - input_pointer) < 1)
            {
                goto fail;
            }

718
            switch (input_pointer[1])
M
Max Bruckner 已提交
719 720
            {
                case 'b':
721
                    *output_pointer++ = '\b';
M
Max Bruckner 已提交
722 723
                    break;
                case 'f':
724
                    *output_pointer++ = '\f';
M
Max Bruckner 已提交
725 726
                    break;
                case 'n':
727
                    *output_pointer++ = '\n';
M
Max Bruckner 已提交
728 729
                    break;
                case 'r':
730
                    *output_pointer++ = '\r';
M
Max Bruckner 已提交
731 732
                    break;
                case 't':
733
                    *output_pointer++ = '\t';
M
Max Bruckner 已提交
734
                    break;
735 736 737
                case '\"':
                case '\\':
                case '/':
738
                    *output_pointer++ = input_pointer[1];
739
                    break;
740 741

                /* UTF-16 literal */
M
Max Bruckner 已提交
742
                case 'u':
743
                    sequence_length = utf16_literal_to_utf8(input_pointer, input_end, &output_pointer);
744
                    if (sequence_length == 0)
M
Max Bruckner 已提交
745
                    {
746
                        /* failed to convert UTF16-literal to UTF-8 */
747
                        goto fail;
M
Max Bruckner 已提交
748 749
                    }
                    break;
750

M
Max Bruckner 已提交
751
                default:
752
                    goto fail;
M
Max Bruckner 已提交
753
            }
754
            input_pointer += sequence_length;
M
Max Bruckner 已提交
755 756
        }
    }
757 758 759

    /* zero terminate the output */
    *output_pointer = '\0';
M
Max Bruckner 已提交
760

761
    item->type = cJSON_String;
762
    item->valuestring = (char*)output;
763

M
Max Bruckner 已提交
764 765 766
    input_buffer->offset = (size_t) (input_end - input_buffer->content);
    input_buffer->offset++;

767
    return true;
768 769

fail:
770
    if (output != NULL)
771
    {
772
        input_buffer->hooks.deallocate(output);
773 774
    }

775 776 777 778 779
    if (input_pointer != NULL)
    {
        input_buffer->offset = (size_t)(input_pointer - input_buffer->content);
    }

780
    return false;
K
Kevin Branigan 已提交
781 782 783
}

/* Render the cstring provided to an escaped version that can be printed. */
784
static cJSON_bool print_string_ptr(const unsigned char * const input, printbuffer * const output_buffer)
K
Kevin Branigan 已提交
785
{
786 787 788
    const unsigned char *input_pointer = NULL;
    unsigned char *output = NULL;
    unsigned char *output_pointer = NULL;
M
Max Bruckner 已提交
789 790 791
    size_t output_length = 0;
    /* numbers of additional characters needed for escaping */
    size_t escape_characters = 0;
M
Max Bruckner 已提交
792

793
    if (output_buffer == NULL)
M
Max Bruckner 已提交
794
    {
795
        return false;
M
Max Bruckner 已提交
796 797 798
    }

    /* empty string */
799
    if (input == NULL)
M
Max Bruckner 已提交
800
    {
801
        output = ensure(output_buffer, sizeof("\"\""));
802
        if (output == NULL)
M
Max Bruckner 已提交
803
        {
804
            return false;
M
Max Bruckner 已提交
805
        }
806
        strcpy((char*)output, "\"\"");
M
Max Bruckner 已提交
807

808
        return true;
M
Max Bruckner 已提交
809 810 811
    }

    /* set "flag" to 1 if something needs to be escaped */
812
    for (input_pointer = input; *input_pointer; input_pointer++)
M
Max Bruckner 已提交
813
    {
M
Max Bruckner 已提交
814
        switch (*input_pointer)
M
Max Bruckner 已提交
815
        {
M
Max Bruckner 已提交
816 817 818 819 820 821 822 823 824 825 826 827 828 829 830 831 832
            case '\"':
            case '\\':
            case '\b':
            case '\f':
            case '\n':
            case '\r':
            case '\t':
                /* one character escape sequence */
                escape_characters++;
                break;
            default:
                if (*input_pointer < 32)
                {
                    /* UTF-16 escape sequence uXXXX */
                    escape_characters += 5;
                }
                break;
M
Max Bruckner 已提交
833 834
        }
    }
M
Max Bruckner 已提交
835
    output_length = (size_t)(input_pointer - input) + escape_characters;
M
Max Bruckner 已提交
836

837
    output = ensure(output_buffer, output_length + sizeof("\"\""));
838
    if (output == NULL)
M
Max Bruckner 已提交
839
    {
840
        return false;
M
Max Bruckner 已提交
841 842
    }

M
Max Bruckner 已提交
843 844
    /* no characters have to be escaped */
    if (escape_characters == 0)
M
Max Bruckner 已提交
845
    {
M
Max Bruckner 已提交
846 847 848 849 850
        output[0] = '\"';
        memcpy(output + 1, input, output_length);
        output[output_length + 1] = '\"';
        output[output_length + 2] = '\0';

851
        return true;
M
Max Bruckner 已提交
852 853
    }

M
Max Bruckner 已提交
854 855
    output[0] = '\"';
    output_pointer = output + 1;
M
Max Bruckner 已提交
856
    /* copy the string */
M
Max Bruckner 已提交
857
    for (input_pointer = input; *input_pointer != '\0'; (void)input_pointer++, output_pointer++)
M
Max Bruckner 已提交
858
    {
859
        if ((*input_pointer > 31) && (*input_pointer != '\"') && (*input_pointer != '\\'))
M
Max Bruckner 已提交
860 861
        {
            /* normal character, copy */
M
Max Bruckner 已提交
862
            *output_pointer = *input_pointer;
M
Max Bruckner 已提交
863 864 865 866
        }
        else
        {
            /* character needs to be escaped */
867
            *output_pointer++ = '\\';
M
Max Bruckner 已提交
868
            switch (*input_pointer)
M
Max Bruckner 已提交
869 870
            {
                case '\\':
M
Max Bruckner 已提交
871
                    *output_pointer = '\\';
M
Max Bruckner 已提交
872 873
                    break;
                case '\"':
M
Max Bruckner 已提交
874
                    *output_pointer = '\"';
M
Max Bruckner 已提交
875 876
                    break;
                case '\b':
M
Max Bruckner 已提交
877
                    *output_pointer = 'b';
M
Max Bruckner 已提交
878 879
                    break;
                case '\f':
M
Max Bruckner 已提交
880
                    *output_pointer = 'f';
M
Max Bruckner 已提交
881 882
                    break;
                case '\n':
M
Max Bruckner 已提交
883
                    *output_pointer = 'n';
M
Max Bruckner 已提交
884 885
                    break;
                case '\r':
M
Max Bruckner 已提交
886
                    *output_pointer = 'r';
M
Max Bruckner 已提交
887 888
                    break;
                case '\t':
M
Max Bruckner 已提交
889
                    *output_pointer = 't';
M
Max Bruckner 已提交
890 891 892
                    break;
                default:
                    /* escape and print as unicode codepoint */
M
Max Bruckner 已提交
893 894
                    sprintf((char*)output_pointer, "u%04x", *input_pointer);
                    output_pointer += 4;
M
Max Bruckner 已提交
895 896 897 898
                    break;
            }
        }
    }
M
Max Bruckner 已提交
899 900
    output[output_length + 1] = '\"';
    output[output_length + 2] = '\0';
M
Max Bruckner 已提交
901

902
    return true;
K
Kevin Branigan 已提交
903
}
M
Max Bruckner 已提交
904

M
Max Bruckner 已提交
905
/* Invoke print_string_ptr (which is useful) on an item. */
906
static cJSON_bool print_string(const cJSON * const item, printbuffer * const p)
M
Max Bruckner 已提交
907
{
908
    return print_string_ptr((unsigned char*)item->valuestring, p);
M
Max Bruckner 已提交
909
}
K
Kevin Branigan 已提交
910 911

/* Predeclare these prototypes. */
912 913 914 915 916 917
static cJSON_bool parse_value(cJSON * const item, parse_buffer * const input_buffer);
static cJSON_bool print_value(const cJSON * const item, printbuffer * const output_buffer);
static cJSON_bool parse_array(cJSON * const item, parse_buffer * const input_buffer);
static cJSON_bool print_array(const cJSON * const item, printbuffer * const output_buffer);
static cJSON_bool parse_object(cJSON * const item, parse_buffer * const input_buffer);
static cJSON_bool print_object(const cJSON * const item, printbuffer * const output_buffer);
K
Kevin Branigan 已提交
918 919

/* Utility to jump whitespace and cr/lf */
M
Max Bruckner 已提交
920
static parse_buffer *buffer_skip_whitespace(parse_buffer * const buffer)
M
Max Bruckner 已提交
921
{
M
Max Bruckner 已提交
922 923 924 925 926
    if ((buffer == NULL) || (buffer->content == NULL))
    {
        return NULL;
    }

M
Max Bruckner 已提交
927 928 929 930 931 932
    while (can_access_at_index(buffer, 0) && (buffer_at_offset(buffer)[0] <= 32))
    {
       buffer->offset++;
    }

    if (buffer->offset == buffer->length)
M
Max Bruckner 已提交
933
    {
M
Max Bruckner 已提交
934
        buffer->offset--;
M
Max Bruckner 已提交
935 936
    }

M
Max Bruckner 已提交
937
    return buffer;
M
Max Bruckner 已提交
938
}
K
Kevin Branigan 已提交
939 940

/* Parse an object - create a new root, and populate. */
941
CJSON_PUBLIC(cJSON *) cJSON_ParseWithOpts(const char *value, const char **return_parse_end, cJSON_bool require_null_terminated)
K
Kevin Branigan 已提交
942
{
943
    parse_buffer buffer = { 0, 0, 0, 0, { 0, 0, 0 } };
944
    cJSON *item = NULL;
945 946 947 948

    /* reset error position */
    global_error.json = NULL;
    global_error.position = 0;
949 950

    if (value == NULL)
M
Max Bruckner 已提交
951
    {
952
        goto fail;
M
Max Bruckner 已提交
953 954
    }

M
Max Bruckner 已提交
955 956 957
    buffer.content = (const unsigned char*)value;
    buffer.length = strlen((const char*)value) + sizeof("");
    buffer.offset = 0;
958
    buffer.hooks = global_hooks;
M
Max Bruckner 已提交
959

960 961 962 963
    item = cJSON_New_Item(&global_hooks);
    if (item == NULL) /* memory fail */
    {
        goto fail;
M
Max Bruckner 已提交
964 965
    }

966
    if (!parse_value(item, buffer_skip_whitespace(&buffer)))
M
Max Bruckner 已提交
967 968
    {
        /* parse failure. ep is set. */
969
        goto fail;
M
Max Bruckner 已提交
970 971 972 973 974
    }

    /* if we require null-terminated JSON without appended garbage, skip and then check for a null terminator */
    if (require_null_terminated)
    {
975 976
        buffer_skip_whitespace(&buffer);
        if ((buffer.offset >= buffer.length) || buffer_at_offset(&buffer)[0] != '\0')
M
Max Bruckner 已提交
977
        {
978
            goto fail;
M
Max Bruckner 已提交
979 980 981 982
        }
    }
    if (return_parse_end)
    {
983
        *return_parse_end = (const char*)buffer_at_offset(&buffer);
M
Max Bruckner 已提交
984 985
    }

986
    return item;
987 988 989 990 991 992 993

fail:
    if (item != NULL)
    {
        cJSON_Delete(item);
    }

994 995
    if (value != NULL)
    {
996 997 998 999
        error local_error;
        local_error.json = (const unsigned char*)value;
        local_error.position = 0;

1000 1001
        if (buffer.offset < buffer.length)
        {
1002
            local_error.position = buffer.offset;
1003 1004 1005
        }
        else if (buffer.length > 0)
        {
1006 1007 1008 1009 1010 1011 1012
            local_error.position = buffer.length - 1;
        }

        if (return_parse_end != NULL)
        {
            *return_parse_end = (const char*)local_error.json + local_error.position;
        }
1013 1014
 
        global_error = local_error;
M
Max Bruckner 已提交
1015 1016
    }

1017
    return NULL;
K
Kevin Branigan 已提交
1018
}
M
Max Bruckner 已提交
1019

1020
/* Default options for cJSON_Parse */
1021
CJSON_PUBLIC(cJSON *) cJSON_Parse(const char *value)
M
Max Bruckner 已提交
1022 1023 1024
{
    return cJSON_ParseWithOpts(value, 0, 0);
}
K
Kevin Branigan 已提交
1025

1026
#define cjson_min(a, b) ((a < b) ? a : b)
M
Max Bruckner 已提交
1027

1028
static unsigned char *print(const cJSON * const item, cJSON_bool format, const internal_hooks * const hooks)
M
Max Bruckner 已提交
1029 1030 1031 1032 1033 1034 1035
{
    printbuffer buffer[1];
    unsigned char *printed = NULL;

    memset(buffer, 0, sizeof(buffer));

    /* create buffer */
1036
    buffer->buffer = (unsigned char*) hooks->allocate(256);
M
Max Bruckner 已提交
1037
    buffer->format = format;
1038
    buffer->hooks = *hooks;
M
Max Bruckner 已提交
1039 1040 1041 1042 1043 1044
    if (buffer->buffer == NULL)
    {
        goto fail;
    }

    /* print the value */
1045
    if (!print_value(item, buffer))
M
Max Bruckner 已提交
1046 1047 1048
    {
        goto fail;
    }
1049
    update_offset(buffer);
M
Max Bruckner 已提交
1050

1051 1052
    /* check if reallocate is available */
    if (hooks->reallocate != NULL)
M
Max Bruckner 已提交
1053
    {
1054 1055 1056 1057 1058
        printed = (unsigned char*) hooks->reallocate(buffer->buffer, buffer->length);
        buffer->buffer = NULL;
        if (printed == NULL) {
            goto fail;
        }
M
Max Bruckner 已提交
1059
    }
1060 1061 1062 1063 1064 1065 1066
    else /* otherwise copy the JSON over to a new buffer */
    {
        printed = (unsigned char*) hooks->allocate(buffer->offset + 1);
        if (printed == NULL)
        {
            goto fail;
        }
1067
        memcpy(printed, buffer->buffer, cjson_min(buffer->length, buffer->offset + 1));
1068
        printed[buffer->offset] = '\0'; /* just to be sure */
M
Max Bruckner 已提交
1069

1070 1071 1072
        /* free the buffer */
        hooks->deallocate(buffer->buffer);
    }
M
Max Bruckner 已提交
1073 1074 1075 1076 1077 1078

    return printed;

fail:
    if (buffer->buffer != NULL)
    {
1079
        hooks->deallocate(buffer->buffer);
M
Max Bruckner 已提交
1080 1081 1082 1083
    }

    if (printed != NULL)
    {
1084
        hooks->deallocate(printed);
M
Max Bruckner 已提交
1085 1086 1087 1088 1089
    }

    return NULL;
}

K
Kevin Branigan 已提交
1090
/* Render a cJSON item/entity/structure to text. */
1091
CJSON_PUBLIC(char *) cJSON_Print(const cJSON *item)
M
Max Bruckner 已提交
1092
{
1093
    return (char*)print(item, true, &global_hooks);
M
Max Bruckner 已提交
1094 1095
}

1096
CJSON_PUBLIC(char *) cJSON_PrintUnformatted(const cJSON *item)
1097
{
1098
    return (char*)print(item, false, &global_hooks);
1099
}
1100

1101
CJSON_PUBLIC(char *) cJSON_PrintBuffered(const cJSON *item, int prebuffer, cJSON_bool fmt)
1102
{
1103
    printbuffer p = { 0, 0, 0, 0, 0, 0, { 0, 0, 0 } };
M
Max Bruckner 已提交
1104 1105 1106

    if (prebuffer < 0)
    {
M
Max Bruckner 已提交
1107
        return NULL;
M
Max Bruckner 已提交
1108 1109
    }

1110
    p.buffer = (unsigned char*)global_hooks.allocate((size_t)prebuffer);
1111 1112
    if (!p.buffer)
    {
1113
        return NULL;
1114
    }
M
Max Bruckner 已提交
1115 1116

    p.length = (size_t)prebuffer;
M
Max Bruckner 已提交
1117
    p.offset = 0;
1118
    p.noalloc = false;
M
Max Bruckner 已提交
1119
    p.format = fmt;
1120
    p.hooks = global_hooks;
M
Max Bruckner 已提交
1121

1122
    if (!print_value(item, &p))
1123
    {
1124
        global_hooks.deallocate(p.buffer);
1125 1126 1127 1128
        return NULL;
    }

    return (char*)p.buffer;
1129 1130
}

1131
CJSON_PUBLIC(cJSON_bool) cJSON_PrintPreallocated(cJSON *item, char *buf, const int len, const cJSON_bool fmt)
1132
{
1133
    printbuffer p = { 0, 0, 0, 0, 0, 0, { 0, 0, 0 } };
M
Max Bruckner 已提交
1134

1135
    if ((len < 0) || (buf == NULL))
M
Max Bruckner 已提交
1136 1137 1138 1139
    {
        return false;
    }

1140
    p.buffer = (unsigned char*)buf;
M
Max Bruckner 已提交
1141
    p.length = (size_t)len;
1142
    p.offset = 0;
1143
    p.noalloc = true;
M
Max Bruckner 已提交
1144
    p.format = fmt;
1145
    p.hooks = global_hooks;
M
Max Bruckner 已提交
1146

1147
    return print_value(item, &p);
1148
}
K
Kevin Branigan 已提交
1149 1150

/* Parser core - when encountering text, process appropriately. */
1151
static cJSON_bool parse_value(cJSON * const item, parse_buffer * const input_buffer)
K
Kevin Branigan 已提交
1152
{
M
Max Bruckner 已提交
1153
    if ((input_buffer == NULL) || (input_buffer->content == NULL))
M
Max Bruckner 已提交
1154
    {
1155
        return false; /* no input */
M
Max Bruckner 已提交
1156 1157 1158
    }

    /* parse the different types of values */
1159
    /* null */
M
Max Bruckner 已提交
1160
    if (can_read(input_buffer, 4) && (strncmp((const char*)buffer_at_offset(input_buffer), "null", 4) == 0))
M
Max Bruckner 已提交
1161 1162
    {
        item->type = cJSON_NULL;
M
Max Bruckner 已提交
1163
        input_buffer->offset += 4;
1164
        return true;
M
Max Bruckner 已提交
1165
    }
1166
    /* false */
M
Max Bruckner 已提交
1167
    if (can_read(input_buffer, 5) && (strncmp((const char*)buffer_at_offset(input_buffer), "false", 5) == 0))
M
Max Bruckner 已提交
1168 1169
    {
        item->type = cJSON_False;
M
Max Bruckner 已提交
1170
        input_buffer->offset += 5;
1171
        return true;
M
Max Bruckner 已提交
1172
    }
1173
    /* true */
M
Max Bruckner 已提交
1174
    if (can_read(input_buffer, 4) && (strncmp((const char*)buffer_at_offset(input_buffer), "true", 4) == 0))
M
Max Bruckner 已提交
1175 1176 1177
    {
        item->type = cJSON_True;
        item->valueint = 1;
M
Max Bruckner 已提交
1178
        input_buffer->offset += 4;
1179
        return true;
M
Max Bruckner 已提交
1180
    }
1181
    /* string */
M
Max Bruckner 已提交
1182
    if (can_access_at_index(input_buffer, 0) && (buffer_at_offset(input_buffer)[0] == '\"'))
M
Max Bruckner 已提交
1183
    {
1184
        return parse_string(item, input_buffer);
M
Max Bruckner 已提交
1185
    }
1186
    /* number */
M
Max Bruckner 已提交
1187
    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'))))
M
Max Bruckner 已提交
1188
    {
M
Max Bruckner 已提交
1189
        return parse_number(item, input_buffer);
M
Max Bruckner 已提交
1190
    }
1191
    /* array */
M
Max Bruckner 已提交
1192
    if (can_access_at_index(input_buffer, 0) && (buffer_at_offset(input_buffer)[0] == '['))
M
Max Bruckner 已提交
1193
    {
1194
        return parse_array(item, input_buffer);
M
Max Bruckner 已提交
1195
    }
1196
    /* object */
M
Max Bruckner 已提交
1197
    if (can_access_at_index(input_buffer, 0) && (buffer_at_offset(input_buffer)[0] == '{'))
M
Max Bruckner 已提交
1198
    {
1199
        return parse_object(item, input_buffer);
M
Max Bruckner 已提交
1200 1201
    }

M
Max Bruckner 已提交
1202

1203
    return false;
K
Kevin Branigan 已提交
1204 1205 1206
}

/* Render a value to text. */
1207
static cJSON_bool print_value(const cJSON * const item, printbuffer * const output_buffer)
K
Kevin Branigan 已提交
1208
{
M
Max Bruckner 已提交
1209
    unsigned char *output = NULL;
M
Max Bruckner 已提交
1210

M
Max Bruckner 已提交
1211
    if ((item == NULL) || (output_buffer == NULL))
M
Max Bruckner 已提交
1212
    {
1213
        return false;
M
Max Bruckner 已提交
1214
    }
M
Max Bruckner 已提交
1215 1216

    switch ((item->type) & 0xFF)
M
Max Bruckner 已提交
1217
    {
M
Max Bruckner 已提交
1218
        case cJSON_NULL:
1219
            output = ensure(output_buffer, 5);
1220
            if (output == NULL)
M
Max Bruckner 已提交
1221
            {
1222
                return false;
M
Max Bruckner 已提交
1223
            }
1224 1225 1226
            strcpy((char*)output, "null");
            return true;

M
Max Bruckner 已提交
1227
        case cJSON_False:
1228
            output = ensure(output_buffer, 6);
1229
            if (output == NULL)
M
Max Bruckner 已提交
1230
            {
1231
                return false;
M
Max Bruckner 已提交
1232
            }
1233 1234 1235
            strcpy((char*)output, "false");
            return true;

M
Max Bruckner 已提交
1236
        case cJSON_True:
1237
            output = ensure(output_buffer, 5);
1238
            if (output == NULL)
M
Max Bruckner 已提交
1239
            {
1240
                return false;
M
Max Bruckner 已提交
1241
            }
1242 1243 1244
            strcpy((char*)output, "true");
            return true;

M
Max Bruckner 已提交
1245
        case cJSON_Number:
1246
            return print_number(item, output_buffer);
1247

M
Max Bruckner 已提交
1248
        case cJSON_Raw:
M
Max Bruckner 已提交
1249
        {
M
Max Bruckner 已提交
1250 1251
            size_t raw_length = 0;
            if (item->valuestring == NULL)
1252
            {
M
Max Bruckner 已提交
1253
                if (!output_buffer->noalloc)
1254
                {
1255
                    output_buffer->hooks.deallocate(output_buffer->buffer);
1256
                }
1257
                return false;
M
Max Bruckner 已提交
1258
            }
1259

1260
            raw_length = strlen(item->valuestring) + sizeof("");
1261
            output = ensure(output_buffer, raw_length);
1262
            if (output == NULL)
M
Max Bruckner 已提交
1263
            {
1264
                return false;
1265
            }
1266 1267
            memcpy(output, item->valuestring, raw_length);
            return true;
M
Max Bruckner 已提交
1268
        }
1269

M
Max Bruckner 已提交
1270
        case cJSON_String:
1271
            return print_string(item, output_buffer);
1272

M
Max Bruckner 已提交
1273
        case cJSON_Array:
1274
            return print_array(item, output_buffer);
1275

M
Max Bruckner 已提交
1276
        case cJSON_Object:
1277
            return print_object(item, output_buffer);
1278

M
Max Bruckner 已提交
1279
        default:
1280
            return false;
M
Max Bruckner 已提交
1281
    }
K
Kevin Branigan 已提交
1282 1283 1284
}

/* Build an array from input text. */
1285
static cJSON_bool parse_array(cJSON * const item, parse_buffer * const input_buffer)
K
Kevin Branigan 已提交
1286
{
1287
    cJSON *head = NULL; /* head of the linked list */
1288 1289
    cJSON *current_item = NULL;

1290 1291 1292 1293 1294 1295
    if (input_buffer->depth >= CJSON_NESTING_LIMIT)
    {
        return false; /* to deeply nested */
    }
    input_buffer->depth++;

M
Max Bruckner 已提交
1296
    if (buffer_at_offset(input_buffer)[0] != '[')
M
Max Bruckner 已提交
1297
    {
1298
        /* not an array */
1299
        goto fail;
M
Max Bruckner 已提交
1300
    }
K
Kevin Branigan 已提交
1301

M
Max Bruckner 已提交
1302 1303 1304
    input_buffer->offset++;
    buffer_skip_whitespace(input_buffer);
    if (can_access_at_index(input_buffer, 0) && (buffer_at_offset(input_buffer)[0] == ']'))
M
Max Bruckner 已提交
1305
    {
1306
        /* empty array */
1307
        goto success;
M
Max Bruckner 已提交
1308
    }
K
Kevin Branigan 已提交
1309

M
Max Bruckner 已提交
1310 1311 1312 1313 1314 1315 1316
    /* check if we skipped to the end of the buffer */
    if (cannot_access_at_index(input_buffer, 0))
    {
        input_buffer->offset--;
        goto fail;
    }

1317
    /* step back to character in front of the first element */
M
Max Bruckner 已提交
1318
    input_buffer->offset--;
M
Max Bruckner 已提交
1319
    /* loop through the comma separated array elements */
1320
    do
M
Max Bruckner 已提交
1321
    {
1322
        /* allocate next item */
1323
        cJSON *new_item = cJSON_New_Item(&(input_buffer->hooks));
1324
        if (new_item == NULL)
M
Max Bruckner 已提交
1325
        {
1326
            goto fail; /* allocation failure */
M
Max Bruckner 已提交
1327
        }
1328 1329 1330

        /* attach next item to list */
        if (head == NULL)
M
Max Bruckner 已提交
1331
        {
1332 1333 1334 1335 1336 1337 1338 1339 1340 1341 1342 1343
            /* start the linked list */
            current_item = head = new_item;
        }
        else
        {
            /* add to the end and advance */
            current_item->next = new_item;
            new_item->prev = current_item;
            current_item = new_item;
        }

        /* parse next value */
M
Max Bruckner 已提交
1344 1345
        input_buffer->offset++;
        buffer_skip_whitespace(input_buffer);
1346
        if (!parse_value(current_item, input_buffer))
1347 1348
        {
            goto fail; /* failed to parse value */
M
Max Bruckner 已提交
1349
        }
M
Max Bruckner 已提交
1350
        buffer_skip_whitespace(input_buffer);
M
Max Bruckner 已提交
1351
    }
M
Max Bruckner 已提交
1352
    while (can_access_at_index(input_buffer, 0) && (buffer_at_offset(input_buffer)[0] == ','));
M
Max Bruckner 已提交
1353

M
Max Bruckner 已提交
1354
    if (cannot_access_at_index(input_buffer, 0) || buffer_at_offset(input_buffer)[0] != ']')
M
Max Bruckner 已提交
1355
    {
1356
        goto fail; /* expected end of array */
M
Max Bruckner 已提交
1357 1358
    }

1359
success:
1360 1361
    input_buffer->depth--;

1362
    item->type = cJSON_Array;
1363
    item->child = head;
1364

M
Max Bruckner 已提交
1365 1366
    input_buffer->offset++;

1367
    return true;
K
Kevin Branigan 已提交
1368

1369
fail:
1370
    if (head != NULL)
1371
    {
1372
        cJSON_Delete(head);
1373 1374
    }

1375
    return false;
K
Kevin Branigan 已提交
1376 1377 1378
}

/* Render an array to text */
1379
static cJSON_bool print_array(const cJSON * const item, printbuffer * const output_buffer)
K
Kevin Branigan 已提交
1380
{
M
Max Bruckner 已提交
1381
    unsigned char *output_pointer = NULL;
M
Max Bruckner 已提交
1382
    size_t length = 0;
M
Max Bruckner 已提交
1383
    cJSON *current_element = item->child;
K
Kevin Branigan 已提交
1384

M
Max Bruckner 已提交
1385
    if (output_buffer == NULL)
M
Max Bruckner 已提交
1386
    {
1387
        return false;
M
Max Bruckner 已提交
1388 1389
    }

M
Max Bruckner 已提交
1390 1391
    /* Compose the output array. */
    /* opening square bracket */
1392
    output_pointer = ensure(output_buffer, 1);
M
Max Bruckner 已提交
1393
    if (output_pointer == NULL)
M
Max Bruckner 已提交
1394
    {
1395
        return false;
M
Max Bruckner 已提交
1396 1397
    }

M
Max Bruckner 已提交
1398 1399
    *output_pointer = '[';
    output_buffer->offset++;
M
Max Bruckner 已提交
1400
    output_buffer->depth++;
M
Max Bruckner 已提交
1401

M
Max Bruckner 已提交
1402
    while (current_element != NULL)
M
Max Bruckner 已提交
1403
    {
1404
        if (!print_value(current_element, output_buffer))
M
Max Bruckner 已提交
1405
        {
1406
            return false;
M
Max Bruckner 已提交
1407
        }
1408
        update_offset(output_buffer);
M
Max Bruckner 已提交
1409
        if (current_element->next)
M
Max Bruckner 已提交
1410
        {
M
Max Bruckner 已提交
1411
            length = (size_t) (output_buffer->format ? 2 : 1);
1412
            output_pointer = ensure(output_buffer, length + 1);
M
Max Bruckner 已提交
1413
            if (output_pointer == NULL)
M
Max Bruckner 已提交
1414
            {
1415
                return false;
M
Max Bruckner 已提交
1416
            }
M
Max Bruckner 已提交
1417
            *output_pointer++ = ',';
M
Max Bruckner 已提交
1418
            if(output_buffer->format)
M
Max Bruckner 已提交
1419
            {
M
Max Bruckner 已提交
1420
                *output_pointer++ = ' ';
M
Max Bruckner 已提交
1421
            }
M
Max Bruckner 已提交
1422 1423
            *output_pointer = '\0';
            output_buffer->offset += length;
M
Max Bruckner 已提交
1424
        }
M
Max Bruckner 已提交
1425
        current_element = current_element->next;
M
Max Bruckner 已提交
1426 1427
    }

1428
    output_pointer = ensure(output_buffer, 2);
M
Max Bruckner 已提交
1429
    if (output_pointer == NULL)
M
Max Bruckner 已提交
1430
    {
1431
        return false;
M
Max Bruckner 已提交
1432
    }
M
Max Bruckner 已提交
1433 1434
    *output_pointer++ = ']';
    *output_pointer = '\0';
M
Max Bruckner 已提交
1435
    output_buffer->depth--;
M
Max Bruckner 已提交
1436

1437
    return true;
K
Kevin Branigan 已提交
1438 1439 1440
}

/* Build an object from the text. */
1441
static cJSON_bool parse_object(cJSON * const item, parse_buffer * const input_buffer)
K
Kevin Branigan 已提交
1442
{
1443
    cJSON *head = NULL; /* linked list head */
1444 1445
    cJSON *current_item = NULL;

1446 1447 1448 1449 1450 1451
    if (input_buffer->depth >= CJSON_NESTING_LIMIT)
    {
        return false; /* to deeply nested */
    }
    input_buffer->depth++;

M
Max Bruckner 已提交
1452
    if (cannot_access_at_index(input_buffer, 0) || (buffer_at_offset(input_buffer)[0] != '{'))
M
Max Bruckner 已提交
1453
    {
1454
        goto fail; /* not an object */
M
Max Bruckner 已提交
1455 1456
    }

M
Max Bruckner 已提交
1457 1458 1459
    input_buffer->offset++;
    buffer_skip_whitespace(input_buffer);
    if (can_access_at_index(input_buffer, 0) && (buffer_at_offset(input_buffer)[0] == '}'))
M
Max Bruckner 已提交
1460
    {
1461
        goto success; /* empty object */
M
Max Bruckner 已提交
1462 1463
    }

M
Max Bruckner 已提交
1464 1465 1466 1467 1468 1469 1470
    /* check if we skipped to the end of the buffer */
    if (cannot_access_at_index(input_buffer, 0))
    {
        input_buffer->offset--;
        goto fail;
    }

1471
    /* step back to character in front of the first element */
M
Max Bruckner 已提交
1472
    input_buffer->offset--;
1473 1474
    /* loop through the comma separated array elements */
    do
M
Max Bruckner 已提交
1475
    {
1476
        /* allocate next item */
1477
        cJSON *new_item = cJSON_New_Item(&(input_buffer->hooks));
1478 1479 1480 1481
        if (new_item == NULL)
        {
            goto fail; /* allocation failure */
        }
M
Max Bruckner 已提交
1482

1483 1484
        /* attach next item to list */
        if (head == NULL)
M
Max Bruckner 已提交
1485
        {
1486 1487 1488 1489 1490 1491 1492 1493 1494
            /* start the linked list */
            current_item = head = new_item;
        }
        else
        {
            /* add to the end and advance */
            current_item->next = new_item;
            new_item->prev = current_item;
            current_item = new_item;
M
Max Bruckner 已提交
1495 1496
        }

1497
        /* parse the name of the child */
M
Max Bruckner 已提交
1498 1499
        input_buffer->offset++;
        buffer_skip_whitespace(input_buffer);
1500
        if (!parse_string(current_item, input_buffer))
M
Max Bruckner 已提交
1501
        {
1502
            goto fail; /* faile to parse name */
M
Max Bruckner 已提交
1503
        }
M
Max Bruckner 已提交
1504
        buffer_skip_whitespace(input_buffer);
M
Max Bruckner 已提交
1505

1506 1507 1508
        /* swap valuestring and string, because we parsed the name */
        current_item->string = current_item->valuestring;
        current_item->valuestring = NULL;
M
Max Bruckner 已提交
1509

M
Max Bruckner 已提交
1510
        if (cannot_access_at_index(input_buffer, 0) || (buffer_at_offset(input_buffer)[0] != ':'))
M
Max Bruckner 已提交
1511
        {
1512
            goto fail; /* invalid object */
M
Max Bruckner 已提交
1513
        }
1514 1515

        /* parse the value */
M
Max Bruckner 已提交
1516 1517
        input_buffer->offset++;
        buffer_skip_whitespace(input_buffer);
1518
        if (!parse_value(current_item, input_buffer))
M
Max Bruckner 已提交
1519
        {
1520
            goto fail; /* failed to parse value */
M
Max Bruckner 已提交
1521
        }
M
Max Bruckner 已提交
1522
        buffer_skip_whitespace(input_buffer);
M
Max Bruckner 已提交
1523
    }
M
Max Bruckner 已提交
1524
    while (can_access_at_index(input_buffer, 0) && (buffer_at_offset(input_buffer)[0] == ','));
1525

M
Max Bruckner 已提交
1526
    if (cannot_access_at_index(input_buffer, 0) || (buffer_at_offset(input_buffer)[0] != '}'))
M
Max Bruckner 已提交
1527
    {
1528
        goto fail; /* expected end of object */
M
Max Bruckner 已提交
1529 1530
    }

1531
success:
1532 1533
    input_buffer->depth--;

1534
    item->type = cJSON_Object;
1535
    item->child = head;
1536

M
Max Bruckner 已提交
1537
    input_buffer->offset++;
1538
    return true;
1539 1540

fail:
1541
    if (head != NULL)
1542
    {
1543
        cJSON_Delete(head);
1544 1545
    }

1546
    return false;
K
Kevin Branigan 已提交
1547 1548 1549
}

/* Render an object to text. */
1550
static cJSON_bool print_object(const cJSON * const item, printbuffer * const output_buffer)
1551
{
M
Max Bruckner 已提交
1552
    unsigned char *output_pointer = NULL;
M
Max Bruckner 已提交
1553
    size_t length = 0;
M
Max Bruckner 已提交
1554
    cJSON *current_item = item->child;
M
Max Bruckner 已提交
1555

M
Max Bruckner 已提交
1556
    if (output_buffer == NULL)
M
Max Bruckner 已提交
1557
    {
1558
        return false;
M
Max Bruckner 已提交
1559 1560
    }

M
Max Bruckner 已提交
1561
    /* Compose the output: */
M
Max Bruckner 已提交
1562
    length = (size_t) (output_buffer->format ? 2 : 1); /* fmt: {\n */
1563
    output_pointer = ensure(output_buffer, length + 1);
M
Max Bruckner 已提交
1564
    if (output_pointer == NULL)
M
Max Bruckner 已提交
1565
    {
1566
        return false;
M
Max Bruckner 已提交
1567 1568
    }

M
Max Bruckner 已提交
1569
    *output_pointer++ = '{';
M
Max Bruckner 已提交
1570
    output_buffer->depth++;
M
Max Bruckner 已提交
1571
    if (output_buffer->format)
M
Max Bruckner 已提交
1572
    {
M
Max Bruckner 已提交
1573
        *output_pointer++ = '\n';
M
Max Bruckner 已提交
1574
    }
M
Max Bruckner 已提交
1575
    output_buffer->offset += length;
M
Max Bruckner 已提交
1576

M
Max Bruckner 已提交
1577
    while (current_item)
M
Max Bruckner 已提交
1578
    {
M
Max Bruckner 已提交
1579
        if (output_buffer->format)
M
Max Bruckner 已提交
1580
        {
M
Max Bruckner 已提交
1581
            size_t i;
1582
            output_pointer = ensure(output_buffer, output_buffer->depth);
M
Max Bruckner 已提交
1583
            if (output_pointer == NULL)
M
Max Bruckner 已提交
1584
            {
1585
                return false;
M
Max Bruckner 已提交
1586
            }
M
Max Bruckner 已提交
1587
            for (i = 0; i < output_buffer->depth; i++)
M
Max Bruckner 已提交
1588
            {
M
Max Bruckner 已提交
1589
                *output_pointer++ = '\t';
M
Max Bruckner 已提交
1590
            }
M
Max Bruckner 已提交
1591
            output_buffer->offset += output_buffer->depth;
M
Max Bruckner 已提交
1592 1593
        }

M
Max Bruckner 已提交
1594
        /* print key */
1595
        if (!print_string_ptr((unsigned char*)current_item->string, output_buffer))
M
Max Bruckner 已提交
1596
        {
1597
            return false;
M
Max Bruckner 已提交
1598
        }
M
Max Bruckner 已提交
1599
        update_offset(output_buffer);
M
Max Bruckner 已提交
1600

M
Max Bruckner 已提交
1601
        length = (size_t) (output_buffer->format ? 2 : 1);
1602
        output_pointer = ensure(output_buffer, length);
M
Max Bruckner 已提交
1603
        if (output_pointer == NULL)
M
Max Bruckner 已提交
1604
        {
1605
            return false;
M
Max Bruckner 已提交
1606
        }
M
Max Bruckner 已提交
1607
        *output_pointer++ = ':';
M
Max Bruckner 已提交
1608
        if (output_buffer->format)
M
Max Bruckner 已提交
1609
        {
M
Max Bruckner 已提交
1610
            *output_pointer++ = '\t';
M
Max Bruckner 已提交
1611
        }
M
Max Bruckner 已提交
1612
        output_buffer->offset += length;
M
Max Bruckner 已提交
1613

M
Max Bruckner 已提交
1614
        /* print value */
1615
        if (!print_value(current_item, output_buffer))
M
Max Bruckner 已提交
1616
        {
1617
            return false;
M
Max Bruckner 已提交
1618
        }
M
Max Bruckner 已提交
1619
        update_offset(output_buffer);
M
Max Bruckner 已提交
1620

M
Max Bruckner 已提交
1621
        /* print comma if not last */
M
Max Bruckner 已提交
1622
        length = (size_t) ((output_buffer->format ? 1 : 0) + (current_item->next ? 1 : 0));
1623
        output_pointer = ensure(output_buffer, length + 1);
M
Max Bruckner 已提交
1624
        if (output_pointer == NULL)
M
Max Bruckner 已提交
1625
        {
1626
            return false;
M
Max Bruckner 已提交
1627
        }
M
Max Bruckner 已提交
1628
        if (current_item->next)
M
Max Bruckner 已提交
1629
        {
M
Max Bruckner 已提交
1630
            *output_pointer++ = ',';
M
Max Bruckner 已提交
1631 1632
        }

M
Max Bruckner 已提交
1633
        if (output_buffer->format)
M
Max Bruckner 已提交
1634
        {
M
Max Bruckner 已提交
1635
            *output_pointer++ = '\n';
M
Max Bruckner 已提交
1636
        }
M
Max Bruckner 已提交
1637 1638
        *output_pointer = '\0';
        output_buffer->offset += length;
M
Max Bruckner 已提交
1639

M
Max Bruckner 已提交
1640
        current_item = current_item->next;
M
Max Bruckner 已提交
1641
    }
M
Max Bruckner 已提交
1642

1643
    output_pointer = ensure(output_buffer, output_buffer->format ? (output_buffer->depth + 1) : 2);
M
Max Bruckner 已提交
1644
    if (output_pointer == NULL)
M
Max Bruckner 已提交
1645
    {
1646
        return false;
M
Max Bruckner 已提交
1647
    }
M
Max Bruckner 已提交
1648
    if (output_buffer->format)
M
Max Bruckner 已提交
1649
    {
M
Max Bruckner 已提交
1650
        size_t i;
M
Max Bruckner 已提交
1651
        for (i = 0; i < (output_buffer->depth - 1); i++)
M
Max Bruckner 已提交
1652
        {
M
Max Bruckner 已提交
1653
            *output_pointer++ = '\t';
M
Max Bruckner 已提交
1654 1655
        }
    }
M
Max Bruckner 已提交
1656 1657
    *output_pointer++ = '}';
    *output_pointer = '\0';
M
Max Bruckner 已提交
1658
    output_buffer->depth--;
M
Max Bruckner 已提交
1659

1660
    return true;
K
Kevin Branigan 已提交
1661 1662 1663
}

/* Get Array size/item / object item. */
1664
CJSON_PUBLIC(int) cJSON_GetArraySize(const cJSON *array)
M
Max Bruckner 已提交
1665
{
1666 1667 1668 1669 1670 1671 1672 1673 1674 1675 1676
    cJSON *child = NULL;
    size_t size = 0;

    if (array == NULL)
    {
        return 0;
    }

    child = array->child;

    while(child != NULL)
M
Max Bruckner 已提交
1677
    {
1678 1679
        size++;
        child = child->next;
M
Max Bruckner 已提交
1680
    }
1681 1682 1683

    /* FIXME: Can overflow here. Cannot be fixed without breaking the API */

1684
    return (int)size;
M
Max Bruckner 已提交
1685 1686
}

M
Max Bruckner 已提交
1687
static cJSON* get_array_item(const cJSON *array, size_t index)
M
Max Bruckner 已提交
1688
{
M
Max Bruckner 已提交
1689 1690 1691
    cJSON *current_child = NULL;

    if (array == NULL)
M
Max Bruckner 已提交
1692
    {
M
Max Bruckner 已提交
1693
        return NULL;
M
Max Bruckner 已提交
1694 1695
    }

M
Max Bruckner 已提交
1696 1697 1698 1699 1700 1701 1702 1703
    current_child = array->child;
    while ((current_child != NULL) && (index > 0))
    {
        index--;
        current_child = current_child->next;
    }

    return current_child;
M
Max Bruckner 已提交
1704 1705
}

M
Max Bruckner 已提交
1706
CJSON_PUBLIC(cJSON *) cJSON_GetArrayItem(const cJSON *array, int index)
M
Max Bruckner 已提交
1707
{
M
Max Bruckner 已提交
1708
    if (index < 0)
M
Max Bruckner 已提交
1709
    {
M
Max Bruckner 已提交
1710
        return NULL;
M
Max Bruckner 已提交
1711
    }
M
Max Bruckner 已提交
1712

M
Max Bruckner 已提交
1713
    return get_array_item(array, (size_t)index);
M
Max Bruckner 已提交
1714 1715
}

1716
static cJSON *get_object_item(const cJSON * const object, const char * const name, const cJSON_bool case_sensitive)
1717 1718 1719
{
    cJSON *current_element = NULL;

1720
    if ((object == NULL) || (name == NULL))
1721 1722 1723 1724 1725
    {
        return NULL;
    }

    current_element = object->child;
1726
    if (case_sensitive)
1727
    {
1728 1729 1730 1731 1732 1733 1734 1735 1736 1737 1738
        while ((current_element != NULL) && (strcmp(name, current_element->string) != 0))
        {
            current_element = current_element->next;
        }
    }
    else
    {
        while ((current_element != NULL) && (case_insensitive_strcmp((const unsigned char*)name, (const unsigned char*)(current_element->string)) != 0))
        {
            current_element = current_element->next;
        }
1739 1740 1741 1742 1743
    }

    return current_element;
}

1744
CJSON_PUBLIC(cJSON *) cJSON_GetObjectItem(const cJSON * const object, const char * const string)
1745 1746 1747 1748 1749 1750 1751 1752 1753
{
    return get_object_item(object, string, false);
}

CJSON_PUBLIC(cJSON *) cJSON_GetObjectItemCaseSensitive(const cJSON * const object, const char * const string)
{
    return get_object_item(object, string, true);
}

1754
CJSON_PUBLIC(cJSON_bool) cJSON_HasObjectItem(const cJSON *object, const char *string)
M
Max Bruckner 已提交
1755 1756 1757
{
    return cJSON_GetObjectItem(object, string) ? 1 : 0;
}
K
Kevin Branigan 已提交
1758 1759

/* Utility for array list handling. */
M
Max Bruckner 已提交
1760 1761 1762 1763 1764 1765
static void suffix_object(cJSON *prev, cJSON *item)
{
    prev->next = item;
    item->prev = prev;
}

K
Kevin Branigan 已提交
1766
/* Utility for handling references. */
1767
static cJSON *create_reference(const cJSON *item, const internal_hooks * const hooks)
M
Max Bruckner 已提交
1768
{
1769 1770
    cJSON *reference = NULL;
    if (item == NULL)
M
Max Bruckner 已提交
1771
    {
1772
        return NULL;
M
Max Bruckner 已提交
1773
    }
1774 1775 1776 1777 1778 1779 1780 1781 1782 1783 1784 1785

    reference = cJSON_New_Item(hooks);
    if (reference == NULL)
    {
        return NULL;
    }

    memcpy(reference, item, sizeof(cJSON));
    reference->string = NULL;
    reference->type |= cJSON_IsReference;
    reference->next = reference->prev = NULL;
    return reference;
M
Max Bruckner 已提交
1786
}
K
Kevin Branigan 已提交
1787 1788

/* Add item to array/object. */
1789
CJSON_PUBLIC(void) cJSON_AddItemToArray(cJSON *array, cJSON *item)
M
Max Bruckner 已提交
1790
{
1791 1792 1793
    cJSON *child = NULL;

    if ((item == NULL) || (array == NULL))
M
Max Bruckner 已提交
1794 1795 1796
    {
        return;
    }
1797 1798 1799 1800

    child = array->child;

    if (child == NULL)
M
Max Bruckner 已提交
1801 1802 1803 1804 1805 1806 1807
    {
        /* list is empty, start new one */
        array->child = item;
    }
    else
    {
        /* append to the end */
1808
        while (child->next)
M
Max Bruckner 已提交
1809
        {
1810
            child = child->next;
M
Max Bruckner 已提交
1811
        }
1812
        suffix_object(child, item);
M
Max Bruckner 已提交
1813 1814 1815
    }
}

1816
CJSON_PUBLIC(void) cJSON_AddItemToObject(cJSON *object, const char *string, cJSON *item)
M
Max Bruckner 已提交
1817
{
1818 1819 1820 1821 1822
    if (item == NULL)
    {
        return;
    }

1823
    /* call cJSON_AddItemToObjectCS for code reuse */
1824
    cJSON_AddItemToObjectCS(object, (char*)cJSON_strdup((const unsigned char*)string, &global_hooks), item);
1825 1826
    /* remove cJSON_StringIsConst flag */
    item->type &= ~cJSON_StringIsConst;
M
Max Bruckner 已提交
1827 1828
}

1829 1830 1831
#if defined (__clang__) || ((__GNUC__)  && ((__GNUC__ > 4) || ((__GNUC__ == 4) && (__GNUC_MINOR__ > 5))))
    #pragma GCC diagnostic push
#endif
1832
#ifdef __GNUC__
1833
#pragma GCC diagnostic ignored "-Wcast-qual"
1834 1835
#endif

1836
/* Add an item to an object with constant string as key */
1837
CJSON_PUBLIC(void) cJSON_AddItemToObjectCS(cJSON *object, const char *string, cJSON *item)
1838
{
1839
    if ((item == NULL) || (string == NULL))
1840 1841 1842 1843 1844
    {
        return;
    }
    if (!(item->type & cJSON_StringIsConst) && item->string)
    {
1845
        global_hooks.deallocate(item->string);
1846 1847 1848 1849 1850
    }
    item->string = (char*)string;
    item->type |= cJSON_StringIsConst;
    cJSON_AddItemToArray(object, item);
}
1851 1852 1853
#if defined (__clang__) || ((__GNUC__)  && ((__GNUC__ > 4) || ((__GNUC__ == 4) && (__GNUC_MINOR__ > 5))))
    #pragma GCC diagnostic pop
#endif
1854

1855
CJSON_PUBLIC(void) cJSON_AddItemReferenceToArray(cJSON *array, cJSON *item)
1856
{
1857 1858 1859 1860 1861
    if (array == NULL)
    {
        return;
    }

1862
    cJSON_AddItemToArray(array, create_reference(item, &global_hooks));
1863 1864
}

1865
CJSON_PUBLIC(void) cJSON_AddItemReferenceToObject(cJSON *object, const char *string, cJSON *item)
1866
{
1867 1868 1869 1870 1871
    if ((object == NULL) || (string == NULL))
    {
        return;
    }

1872
    cJSON_AddItemToObject(object, string, create_reference(item, &global_hooks));
1873 1874
}

M
Max Bruckner 已提交
1875
CJSON_PUBLIC(cJSON *) cJSON_DetachItemViaPointer(cJSON *parent, cJSON * const item)
1876
{
M
Max Bruckner 已提交
1877
    if ((parent == NULL) || (item == NULL))
1878
    {
1879
        return NULL;
1880
    }
M
Max Bruckner 已提交
1881 1882

    if (item->prev != NULL)
1883 1884
    {
        /* not the first element */
M
Max Bruckner 已提交
1885
        item->prev->next = item->next;
1886
    }
M
Max Bruckner 已提交
1887
    if (item->next != NULL)
1888
    {
M
Max Bruckner 已提交
1889 1890
        /* not the last element */
        item->next->prev = item->prev;
1891
    }
M
Max Bruckner 已提交
1892 1893

    if (item == parent->child)
1894
    {
M
Max Bruckner 已提交
1895 1896
        /* first element */
        parent->child = item->next;
1897 1898
    }
    /* make sure the detached item doesn't point anywhere anymore */
M
Max Bruckner 已提交
1899 1900
    item->prev = NULL;
    item->next = NULL;
1901

M
Max Bruckner 已提交
1902
    return item;
1903
}
M
Max Bruckner 已提交
1904

1905
CJSON_PUBLIC(cJSON *) cJSON_DetachItemFromArray(cJSON *array, int which)
M
Max Bruckner 已提交
1906 1907 1908 1909 1910 1911
{
    if (which < 0)
    {
        return NULL;
    }

M
Max Bruckner 已提交
1912
    return cJSON_DetachItemViaPointer(array, get_array_item(array, (size_t)which));
M
Max Bruckner 已提交
1913
}
K
Kevin Branigan 已提交
1914

1915
CJSON_PUBLIC(void) cJSON_DeleteItemFromArray(cJSON *array, int which)
1916 1917 1918 1919
{
    cJSON_Delete(cJSON_DetachItemFromArray(array, which));
}

1920
CJSON_PUBLIC(cJSON *) cJSON_DetachItemFromObject(cJSON *object, const char *string)
1921
{
1922
    cJSON *to_detach = cJSON_GetObjectItem(object, string);
1923

1924 1925 1926 1927 1928 1929
    return cJSON_DetachItemViaPointer(object, to_detach);
}

CJSON_PUBLIC(cJSON *) cJSON_DetachItemFromObjectCaseSensitive(cJSON *object, const char *string)
{
    cJSON *to_detach = cJSON_GetObjectItemCaseSensitive(object, string);
1930

1931
    return cJSON_DetachItemViaPointer(object, to_detach);
1932 1933
}

1934
CJSON_PUBLIC(void) cJSON_DeleteItemFromObject(cJSON *object, const char *string)
1935 1936 1937
{
    cJSON_Delete(cJSON_DetachItemFromObject(object, string));
}
K
Kevin Branigan 已提交
1938

1939 1940 1941 1942 1943
CJSON_PUBLIC(void) cJSON_DeleteItemFromObjectCaseSensitive(cJSON *object, const char *string)
{
    cJSON_Delete(cJSON_DetachItemFromObjectCaseSensitive(object, string));
}

K
Kevin Branigan 已提交
1944
/* Replace array/object items with new ones. */
1945
CJSON_PUBLIC(void) cJSON_InsertItemInArray(cJSON *array, int which, cJSON *newitem)
1946
{
M
Max Bruckner 已提交
1947 1948 1949
    cJSON *after_inserted = NULL;

    if (which < 0)
1950
    {
M
Max Bruckner 已提交
1951
        return;
1952
    }
M
Max Bruckner 已提交
1953 1954 1955

    after_inserted = get_array_item(array, (size_t)which);
    if (after_inserted == NULL)
1956 1957 1958 1959
    {
        cJSON_AddItemToArray(array, newitem);
        return;
    }
M
Max Bruckner 已提交
1960 1961 1962 1963 1964

    newitem->next = after_inserted;
    newitem->prev = after_inserted->prev;
    after_inserted->prev = newitem;
    if (after_inserted == array->child)
1965 1966 1967 1968 1969 1970 1971 1972 1973
    {
        array->child = newitem;
    }
    else
    {
        newitem->prev->next = newitem;
    }
}

M
Max Bruckner 已提交
1974
CJSON_PUBLIC(cJSON_bool) cJSON_ReplaceItemViaPointer(cJSON * const parent, cJSON * const item, cJSON * replacement)
1975
{
1976
    if ((parent == NULL) || (replacement == NULL) || (item == NULL))
1977
    {
M
Max Bruckner 已提交
1978
        return false;
1979
    }
M
Max Bruckner 已提交
1980

M
Max Bruckner 已提交
1981
    if (replacement == item)
1982
    {
M
Max Bruckner 已提交
1983
        return true;
1984
    }
M
Max Bruckner 已提交
1985

M
Max Bruckner 已提交
1986 1987 1988 1989
    replacement->next = item->next;
    replacement->prev = item->prev;

    if (replacement->next != NULL)
1990
    {
M
Max Bruckner 已提交
1991
        replacement->next->prev = replacement;
1992
    }
M
Max Bruckner 已提交
1993
    if (replacement->prev != NULL)
1994
    {
M
Max Bruckner 已提交
1995
        replacement->prev->next = replacement;
1996
    }
M
Max Bruckner 已提交
1997
    if (parent->child == item)
1998
    {
M
Max Bruckner 已提交
1999
        parent->child = replacement;
2000
    }
M
Max Bruckner 已提交
2001

M
Max Bruckner 已提交
2002 2003 2004
    item->next = NULL;
    item->prev = NULL;
    cJSON_Delete(item);
M
Max Bruckner 已提交
2005

M
Max Bruckner 已提交
2006
    return true;
2007
}
M
Max Bruckner 已提交
2008

2009
CJSON_PUBLIC(void) cJSON_ReplaceItemInArray(cJSON *array, int which, cJSON *newitem)
M
Max Bruckner 已提交
2010 2011 2012 2013 2014 2015
{
    if (which < 0)
    {
        return;
    }

M
Max Bruckner 已提交
2016
    cJSON_ReplaceItemViaPointer(array, get_array_item(array, (size_t)which), newitem);
M
Max Bruckner 已提交
2017
}
2018

2019 2020
static cJSON_bool replace_item_in_object(cJSON *object, const char *string, cJSON *replacement, cJSON_bool case_sensitive)
{
2021
    if ((replacement == NULL) || (string == NULL))
2022 2023 2024 2025 2026 2027 2028 2029 2030 2031 2032 2033 2034 2035 2036 2037 2038
    {
        return false;
    }

    /* replace the name in the replacement */
    if (!(replacement->type & cJSON_StringIsConst) && (replacement->string != NULL))
    {
        cJSON_free(replacement->string);
    }
    replacement->string = (char*)cJSON_strdup((const unsigned char*)string, &global_hooks);
    replacement->type &= ~cJSON_StringIsConst;

    cJSON_ReplaceItemViaPointer(object, get_object_item(object, string, case_sensitive), replacement);

    return true;
}

2039
CJSON_PUBLIC(void) cJSON_ReplaceItemInObject(cJSON *object, const char *string, cJSON *newitem)
2040
{
2041
    replace_item_in_object(object, string, newitem, false);
2042
}
2043

2044 2045
CJSON_PUBLIC(void) cJSON_ReplaceItemInObjectCaseSensitive(cJSON *object, const char *string, cJSON *newitem)
{
2046
    replace_item_in_object(object, string, newitem, true);
2047
}
K
Kevin Branigan 已提交
2048 2049

/* Create basic types: */
2050
CJSON_PUBLIC(cJSON *) cJSON_CreateNull(void)
M
Max Bruckner 已提交
2051
{
2052
    cJSON *item = cJSON_New_Item(&global_hooks);
M
Max Bruckner 已提交
2053 2054 2055 2056 2057 2058 2059 2060
    if(item)
    {
        item->type = cJSON_NULL;
    }

    return item;
}

2061
CJSON_PUBLIC(cJSON *) cJSON_CreateTrue(void)
M
Max Bruckner 已提交
2062
{
2063
    cJSON *item = cJSON_New_Item(&global_hooks);
M
Max Bruckner 已提交
2064 2065 2066 2067 2068 2069 2070 2071
    if(item)
    {
        item->type = cJSON_True;
    }

    return item;
}

2072
CJSON_PUBLIC(cJSON *) cJSON_CreateFalse(void)
M
Max Bruckner 已提交
2073
{
2074
    cJSON *item = cJSON_New_Item(&global_hooks);
M
Max Bruckner 已提交
2075 2076 2077 2078 2079 2080 2081 2082
    if(item)
    {
        item->type = cJSON_False;
    }

    return item;
}

2083
CJSON_PUBLIC(cJSON *) cJSON_CreateBool(cJSON_bool b)
M
Max Bruckner 已提交
2084
{
2085
    cJSON *item = cJSON_New_Item(&global_hooks);
M
Max Bruckner 已提交
2086 2087 2088 2089 2090 2091 2092 2093
    if(item)
    {
        item->type = b ? cJSON_True : cJSON_False;
    }

    return item;
}

2094
CJSON_PUBLIC(cJSON *) cJSON_CreateNumber(double num)
M
Max Bruckner 已提交
2095
{
2096
    cJSON *item = cJSON_New_Item(&global_hooks);
M
Max Bruckner 已提交
2097 2098 2099 2100
    if(item)
    {
        item->type = cJSON_Number;
        item->valuedouble = num;
2101 2102 2103 2104 2105 2106 2107 2108 2109 2110 2111 2112 2113 2114

        /* use saturation in case of overflow */
        if (num >= INT_MAX)
        {
            item->valueint = INT_MAX;
        }
        else if (num <= INT_MIN)
        {
            item->valueint = INT_MIN;
        }
        else
        {
            item->valueint = (int)num;
        }
M
Max Bruckner 已提交
2115 2116 2117 2118 2119
    }

    return item;
}

2120
CJSON_PUBLIC(cJSON *) cJSON_CreateString(const char *string)
M
Max Bruckner 已提交
2121
{
2122
    cJSON *item = cJSON_New_Item(&global_hooks);
M
Max Bruckner 已提交
2123 2124 2125
    if(item)
    {
        item->type = cJSON_String;
2126
        item->valuestring = (char*)cJSON_strdup((const unsigned char*)string, &global_hooks);
M
Max Bruckner 已提交
2127 2128 2129
        if(!item->valuestring)
        {
            cJSON_Delete(item);
2130
            return NULL;
M
Max Bruckner 已提交
2131 2132 2133 2134 2135 2136
        }
    }

    return item;
}

2137
CJSON_PUBLIC(cJSON *) cJSON_CreateRaw(const char *raw)
J
Jiri Zouhar 已提交
2138
{
2139
    cJSON *item = cJSON_New_Item(&global_hooks);
M
Max Bruckner 已提交
2140 2141 2142
    if(item)
    {
        item->type = cJSON_Raw;
2143
        item->valuestring = (char*)cJSON_strdup((const unsigned char*)raw, &global_hooks);
M
Max Bruckner 已提交
2144 2145 2146 2147 2148 2149 2150 2151
        if(!item->valuestring)
        {
            cJSON_Delete(item);
            return NULL;
        }
    }

    return item;
J
Jiri Zouhar 已提交
2152 2153
}

2154
CJSON_PUBLIC(cJSON *) cJSON_CreateArray(void)
M
Max Bruckner 已提交
2155
{
2156
    cJSON *item = cJSON_New_Item(&global_hooks);
M
Max Bruckner 已提交
2157 2158 2159 2160 2161 2162 2163 2164
    if(item)
    {
        item->type=cJSON_Array;
    }

    return item;
}

2165
CJSON_PUBLIC(cJSON *) cJSON_CreateObject(void)
M
Max Bruckner 已提交
2166
{
2167
    cJSON *item = cJSON_New_Item(&global_hooks);
M
Max Bruckner 已提交
2168 2169 2170 2171 2172 2173 2174
    if (item)
    {
        item->type = cJSON_Object;
    }

    return item;
}
K
Kevin Branigan 已提交
2175 2176

/* Create Arrays: */
2177
CJSON_PUBLIC(cJSON *) cJSON_CreateIntArray(const int *numbers, int count)
M
Max Bruckner 已提交
2178
{
2179
    size_t i = 0;
2180 2181
    cJSON *n = NULL;
    cJSON *p = NULL;
2182 2183
    cJSON *a = NULL;

2184
    if ((count < 0) || (numbers == NULL))
2185 2186 2187 2188 2189 2190
    {
        return NULL;
    }

    a = cJSON_CreateArray();
    for(i = 0; a && (i < (size_t)count); i++)
M
Max Bruckner 已提交
2191 2192 2193 2194 2195
    {
        n = cJSON_CreateNumber(numbers[i]);
        if (!n)
        {
            cJSON_Delete(a);
2196
            return NULL;
M
Max Bruckner 已提交
2197 2198 2199 2200 2201 2202 2203 2204 2205 2206 2207 2208 2209 2210 2211
        }
        if(!i)
        {
            a->child = n;
        }
        else
        {
            suffix_object(p, n);
        }
        p = n;
    }

    return a;
}

2212
CJSON_PUBLIC(cJSON *) cJSON_CreateFloatArray(const float *numbers, int count)
M
Max Bruckner 已提交
2213
{
2214
    size_t i = 0;
2215 2216
    cJSON *n = NULL;
    cJSON *p = NULL;
2217 2218
    cJSON *a = NULL;

2219
    if ((count < 0) || (numbers == NULL))
2220 2221 2222 2223 2224 2225 2226
    {
        return NULL;
    }

    a = cJSON_CreateArray();

    for(i = 0; a && (i < (size_t)count); i++)
M
Max Bruckner 已提交
2227
    {
2228
        n = cJSON_CreateNumber((double)numbers[i]);
M
Max Bruckner 已提交
2229 2230 2231
        if(!n)
        {
            cJSON_Delete(a);
2232
            return NULL;
M
Max Bruckner 已提交
2233 2234 2235 2236 2237 2238 2239 2240 2241 2242 2243 2244 2245 2246 2247
        }
        if(!i)
        {
            a->child = n;
        }
        else
        {
            suffix_object(p, n);
        }
        p = n;
    }

    return a;
}

2248
CJSON_PUBLIC(cJSON *) cJSON_CreateDoubleArray(const double *numbers, int count)
2249
{
2250
    size_t i = 0;
2251 2252
    cJSON *n = NULL;
    cJSON *p = NULL;
2253 2254
    cJSON *a = NULL;

2255
    if ((count < 0) || (numbers == NULL))
2256 2257 2258 2259 2260 2261 2262
    {
        return NULL;
    }

    a = cJSON_CreateArray();

    for(i = 0;a && (i < (size_t)count); i++)
2263 2264 2265 2266 2267
    {
        n = cJSON_CreateNumber(numbers[i]);
        if(!n)
        {
            cJSON_Delete(a);
2268
            return NULL;
2269 2270 2271 2272 2273 2274 2275 2276 2277 2278 2279 2280 2281 2282 2283
        }
        if(!i)
        {
            a->child = n;
        }
        else
        {
            suffix_object(p, n);
        }
        p = n;
    }

    return a;
}

2284
CJSON_PUBLIC(cJSON *) cJSON_CreateStringArray(const char **strings, int count)
2285
{
2286
    size_t i = 0;
2287 2288
    cJSON *n = NULL;
    cJSON *p = NULL;
2289 2290
    cJSON *a = NULL;

2291
    if ((count < 0) || (strings == NULL))
2292 2293 2294 2295 2296 2297 2298
    {
        return NULL;
    }

    a = cJSON_CreateArray();

    for (i = 0; a && (i < (size_t)count); i++)
2299 2300 2301 2302 2303
    {
        n = cJSON_CreateString(strings[i]);
        if(!n)
        {
            cJSON_Delete(a);
2304
            return NULL;
2305 2306 2307 2308 2309 2310 2311 2312 2313 2314 2315 2316 2317 2318
        }
        if(!i)
        {
            a->child = n;
        }
        else
        {
            suffix_object(p,n);
        }
        p = n;
    }

    return a;
}
2319 2320

/* Duplication */
2321
CJSON_PUBLIC(cJSON *) cJSON_Duplicate(const cJSON *item, cJSON_bool recurse)
2322
{
M
Max Bruckner 已提交
2323
    cJSON *newitem = NULL;
2324 2325
    cJSON *child = NULL;
    cJSON *next = NULL;
M
Max Bruckner 已提交
2326
    cJSON *newchild = NULL;
M
Max Bruckner 已提交
2327 2328 2329 2330

    /* Bail on bad ptr */
    if (!item)
    {
2331
        goto fail;
M
Max Bruckner 已提交
2332 2333
    }
    /* Create new item */
2334
    newitem = cJSON_New_Item(&global_hooks);
M
Max Bruckner 已提交
2335 2336
    if (!newitem)
    {
2337
        goto fail;
M
Max Bruckner 已提交
2338 2339 2340 2341 2342 2343 2344
    }
    /* Copy over all vars */
    newitem->type = item->type & (~cJSON_IsReference);
    newitem->valueint = item->valueint;
    newitem->valuedouble = item->valuedouble;
    if (item->valuestring)
    {
2345
        newitem->valuestring = (char*)cJSON_strdup((unsigned char*)item->valuestring, &global_hooks);
M
Max Bruckner 已提交
2346 2347
        if (!newitem->valuestring)
        {
2348
            goto fail;
M
Max Bruckner 已提交
2349 2350 2351 2352
        }
    }
    if (item->string)
    {
2353
        newitem->string = (item->type&cJSON_StringIsConst) ? item->string : (char*)cJSON_strdup((unsigned char*)item->string, &global_hooks);
M
Max Bruckner 已提交
2354 2355
        if (!newitem->string)
        {
2356
            goto fail;
M
Max Bruckner 已提交
2357 2358 2359 2360 2361 2362 2363 2364
        }
    }
    /* If non-recursive, then we're done! */
    if (!recurse)
    {
        return newitem;
    }
    /* Walk the ->next chain for the child. */
2365 2366
    child = item->child;
    while (child != NULL)
M
Max Bruckner 已提交
2367
    {
2368
        newchild = cJSON_Duplicate(child, true); /* Duplicate (with recurse) each item in the ->next chain */
M
Max Bruckner 已提交
2369 2370
        if (!newchild)
        {
2371
            goto fail;
M
Max Bruckner 已提交
2372
        }
2373
        if (next != NULL)
M
Max Bruckner 已提交
2374 2375
        {
            /* If newitem->child already set, then crosswire ->prev and ->next and move on */
2376 2377 2378
            next->next = newchild;
            newchild->prev = next;
            next = newchild;
M
Max Bruckner 已提交
2379 2380 2381 2382
        }
        else
        {
            /* Set newitem->child and move to it */
2383 2384
            newitem->child = newchild;
            next = newchild;
M
Max Bruckner 已提交
2385
        }
2386
        child = child->next;
M
Max Bruckner 已提交
2387 2388 2389
    }

    return newitem;
2390 2391 2392 2393 2394 2395 2396 2397

fail:
    if (newitem != NULL)
    {
        cJSON_Delete(newitem);
    }

    return NULL;
2398
}
2399

2400
CJSON_PUBLIC(void) cJSON_Minify(char *json)
2401
{
2402
    unsigned char *into = (unsigned char*)json;
2403 2404 2405 2406 2407 2408

    if (json == NULL)
    {
        return;
    }

M
Max Bruckner 已提交
2409 2410 2411 2412 2413 2414 2415 2416 2417 2418 2419 2420 2421 2422 2423 2424 2425 2426 2427 2428 2429 2430 2431 2432 2433 2434 2435 2436 2437 2438 2439 2440 2441 2442 2443 2444 2445 2446 2447
    while (*json)
    {
        if (*json == ' ')
        {
            json++;
        }
        else if (*json == '\t')
        {
            /* Whitespace characters. */
            json++;
        }
        else if (*json == '\r')
        {
            json++;
        }
        else if (*json=='\n')
        {
            json++;
        }
        else if ((*json == '/') && (json[1] == '/'))
        {
            /* double-slash comments, to end of line. */
            while (*json && (*json != '\n'))
            {
                json++;
            }
        }
        else if ((*json == '/') && (json[1] == '*'))
        {
            /* multiline comments. */
            while (*json && !((*json == '*') && (json[1] == '/')))
            {
                json++;
            }
            json += 2;
        }
        else if (*json == '\"')
        {
            /* string literals, which are \" sensitive. */
M
Max Bruckner 已提交
2448
            *into++ = (unsigned char)*json++;
M
Max Bruckner 已提交
2449 2450 2451 2452
            while (*json && (*json != '\"'))
            {
                if (*json == '\\')
                {
M
Max Bruckner 已提交
2453
                    *into++ = (unsigned char)*json++;
M
Max Bruckner 已提交
2454
                }
M
Max Bruckner 已提交
2455
                *into++ = (unsigned char)*json++;
M
Max Bruckner 已提交
2456
            }
M
Max Bruckner 已提交
2457
            *into++ = (unsigned char)*json++;
M
Max Bruckner 已提交
2458 2459 2460 2461
        }
        else
        {
            /* All other characters. */
M
Max Bruckner 已提交
2462
            *into++ = (unsigned char)*json++;
M
Max Bruckner 已提交
2463 2464 2465 2466 2467
        }
    }

    /* and null-terminate. */
    *into = '\0';
2468
}
2469

2470
CJSON_PUBLIC(cJSON_bool) cJSON_IsInvalid(const cJSON * const item)
2471 2472 2473 2474 2475 2476 2477 2478 2479
{
    if (item == NULL)
    {
        return false;
    }

    return (item->type & 0xFF) == cJSON_Invalid;
}

2480
CJSON_PUBLIC(cJSON_bool) cJSON_IsFalse(const cJSON * const item)
2481 2482 2483 2484 2485 2486 2487 2488 2489
{
    if (item == NULL)
    {
        return false;
    }

    return (item->type & 0xFF) == cJSON_False;
}

2490
CJSON_PUBLIC(cJSON_bool) cJSON_IsTrue(const cJSON * const item)
2491 2492 2493 2494 2495 2496 2497 2498 2499 2500
{
    if (item == NULL)
    {
        return false;
    }

    return (item->type & 0xff) == cJSON_True;
}


2501
CJSON_PUBLIC(cJSON_bool) cJSON_IsBool(const cJSON * const item)
2502 2503 2504 2505 2506 2507 2508 2509
{
    if (item == NULL)
    {
        return false;
    }

    return (item->type & (cJSON_True | cJSON_False)) != 0;
}
2510
CJSON_PUBLIC(cJSON_bool) cJSON_IsNull(const cJSON * const item)
2511 2512 2513 2514 2515 2516 2517 2518 2519
{
    if (item == NULL)
    {
        return false;
    }

    return (item->type & 0xFF) == cJSON_NULL;
}

2520
CJSON_PUBLIC(cJSON_bool) cJSON_IsNumber(const cJSON * const item)
2521 2522 2523 2524 2525 2526 2527 2528 2529
{
    if (item == NULL)
    {
        return false;
    }

    return (item->type & 0xFF) == cJSON_Number;
}

2530
CJSON_PUBLIC(cJSON_bool) cJSON_IsString(const cJSON * const item)
2531 2532 2533 2534 2535 2536 2537 2538 2539
{
    if (item == NULL)
    {
        return false;
    }

    return (item->type & 0xFF) == cJSON_String;
}

2540
CJSON_PUBLIC(cJSON_bool) cJSON_IsArray(const cJSON * const item)
2541 2542 2543 2544 2545 2546 2547 2548 2549
{
    if (item == NULL)
    {
        return false;
    }

    return (item->type & 0xFF) == cJSON_Array;
}

2550
CJSON_PUBLIC(cJSON_bool) cJSON_IsObject(const cJSON * const item)
2551 2552 2553 2554 2555 2556 2557 2558 2559
{
    if (item == NULL)
    {
        return false;
    }

    return (item->type & 0xFF) == cJSON_Object;
}

2560
CJSON_PUBLIC(cJSON_bool) cJSON_IsRaw(const cJSON * const item)
2561 2562 2563 2564 2565 2566 2567 2568
{
    if (item == NULL)
    {
        return false;
    }

    return (item->type & 0xFF) == cJSON_Raw;
}
2569 2570 2571 2572 2573 2574 2575 2576 2577 2578 2579 2580 2581 2582 2583 2584 2585 2586 2587 2588 2589 2590 2591 2592 2593 2594 2595 2596 2597 2598 2599 2600 2601 2602 2603 2604 2605 2606 2607 2608 2609 2610 2611 2612 2613 2614 2615 2616 2617 2618 2619 2620 2621 2622 2623 2624 2625 2626 2627 2628 2629

CJSON_PUBLIC(cJSON_bool) cJSON_Compare(const cJSON * const a, const cJSON * const b, const cJSON_bool case_sensitive)
{
    if ((a == NULL) || (b == NULL) || ((a->type & 0xFF) != (b->type & 0xFF)) || cJSON_IsInvalid(a))
    {
        return false;
    }

    /* check if type is valid */
    switch (a->type & 0xFF)
    {
        case cJSON_False:
        case cJSON_True:
        case cJSON_NULL:
        case cJSON_Number:
        case cJSON_String:
        case cJSON_Raw:
        case cJSON_Array:
        case cJSON_Object:
            break;

        default:
            return false;
    }

    /* identical objects are equal */
    if (a == b)
    {
        return true;
    }

    switch (a->type & 0xFF)
    {
        /* in these cases and equal type is enough */
        case cJSON_False:
        case cJSON_True:
        case cJSON_NULL:
            return true;

        case cJSON_Number:
            if (a->valuedouble == b->valuedouble)
            {
                return true;
            }
            return false;

        case cJSON_String:
        case cJSON_Raw:
            if ((a->valuestring == NULL) || (b->valuestring == NULL))
            {
                return false;
            }
            if (strcmp(a->valuestring, b->valuestring) == 0)
            {
                return true;
            }

            return false;

        case cJSON_Array:
        {
M
Max Bruckner 已提交
2630 2631 2632 2633
            cJSON *a_element = a->child;
            cJSON *b_element = b->child;

            for (; (a_element != NULL) && (b_element != NULL);)
2634 2635 2636 2637 2638
            {
                if (!cJSON_Compare(a_element, b_element, case_sensitive))
                {
                    return false;
                }
M
Max Bruckner 已提交
2639 2640 2641

                a_element = a_element->next;
                b_element = b_element->next;
2642 2643
            }

2644 2645 2646 2647 2648
            /* one of the arrays is longer than the other */
            if (a_element != b_element) {
                return false;
            }

2649 2650 2651 2652 2653 2654
            return true;
        }

        case cJSON_Object:
        {
            cJSON *a_element = NULL;
2655
            cJSON *b_element = NULL;
2656 2657 2658
            cJSON_ArrayForEach(a_element, a)
            {
                /* TODO This has O(n^2) runtime, which is horrible! */
2659
                b_element = get_object_item(b, a_element->string, case_sensitive);
2660 2661 2662 2663 2664 2665 2666 2667 2668 2669 2670
                if (b_element == NULL)
                {
                    return false;
                }

                if (!cJSON_Compare(a_element, b_element, case_sensitive))
                {
                    return false;
                }
            }

2671 2672 2673 2674 2675 2676 2677 2678 2679 2680 2681 2682 2683 2684 2685 2686
            /* doing this twice, once on a and b to prevent true comparison if a subset of b
             * TODO: Do this the proper way, this is just a fix for now */
            cJSON_ArrayForEach(b_element, b)
            {
                a_element = get_object_item(a, b_element->string, case_sensitive);
                if (a_element == NULL)
                {
                    return false;
                }

                if (!cJSON_Compare(b_element, a_element, case_sensitive))
                {
                    return false;
                }
            }

2687 2688 2689 2690 2691 2692 2693
            return true;
        }

        default:
            return false;
    }
}
2694 2695 2696 2697 2698 2699 2700 2701 2702 2703

CJSON_PUBLIC(void *) cJSON_malloc(size_t size)
{
    return global_hooks.allocate(size);
}

CJSON_PUBLIC(void) cJSON_free(void *object)
{
    global_hooks.deallocate(object);
}