cJSON库, cJSON_free和free区别

在cJSON库中，cJSON_free和free都是用于释放动态分配的内存的函数，但它们有一些重要的区别和联系。

free函数

free是C标准库中的一个函数，用于释放之前通过malloc、calloc或realloc等函数分配的内存。当你使用这些函数动态分配内存后，一旦这块内存不再需要，就应该使用free函数来释放它，以避免内存泄漏。

cJSON_free函数

cJSON_free是cJSON库提供的一个特定函数，用于释放与cJSON对象相关的内存。当你使用cJSON库创建或解析JSON对象时，库内部可能会分配一些内存来存储JSON数据。这些内存块不是通过标准的malloc等函数分配的，而是由cJSON库自己管理的。
因此，当你不再需要一个cJSON对象时，应该使用cJSON_free来释放它，而不是使用free。这是因为cJSON_free知道如何正确地处理cJSON对象内部可能存在的复杂结构（如嵌套的对象和数组），并确保所有相关的内存都被正确释放。

区别和联系

区别：
free是C标准库函数，用于释放任何通过malloc等函数分配的内存。
cJSON_free是cJSON库特有的函数，用于释放与cJSON对象相关的内存。
联系：
在某些情况下，cJSON_free可能会调用free来释放它管理的内存块。但是，这是cJSON库内部的实现细节，你不应该直接依赖这一点。
无论是使用free还是cJSON_free，重要的是要确保你释放的内存是你之前分配的，并且只释放一次。重复释放或释放未分配的内存都会导致未定义行为（如程序崩溃）。
使用建议
当你使用cJSON库处理JSON数据时，始终使用cJSON_free来释放cJSON对象。
不要试图使用free来释放cJSON对象，除非你确定你正在处理的是由cJSON库外部分配的内存块（这通常是不常见的）。
遵循这些建议可以帮助你避免内存管理错误，并确保你的程序更加健壮和可靠

2. 代码

/* Create a bunch of objects as demonstration. */
static int print_preallocated(cJSON *root)
{
    /* declarations */
    char *out = NULL;
    char *buf = NULL;
    char *buf_fail = NULL;
    size_t len = 0;
    size_t len_fail = 0;
 
    /* formatted print */
    out = cJSON_Print(root);
 
    /* create buffer to succeed */
    /* the extra 5 bytes are because of inaccuracies when reserving memory */
    len = strlen(out) + 5;
    buf = (char*)malloc(len);
    if (buf == NULL)
    {
        printf("Failed to allocate memory.\n");
        exit(1);
    }
 
    /* create buffer to fail */
    len_fail = strlen(out);
    buf_fail = (char*)malloc(len_fail);
    if (buf_fail == NULL)
    {
        printf("Failed to allocate memory.\n");
        exit(1);
    }
 
    /* Print to buffer */
    if (!cJSON_PrintPreallocated(root, buf, (int)len, 1)) {
        printf("cJSON_PrintPreallocated failed!\n");
        if (strcmp(out, buf) != 0) {
            printf("cJSON_PrintPreallocated not the same as cJSON_Print!\n");
            printf("cJSON_Print result:\n%s\n", out);
            printf("cJSON_PrintPreallocated result:\n%s\n", buf);
        }
        free(out);
        free(buf_fail);
        free(buf);
        return -1;
    }
 
    /* success */
    printf("%s\n", buf);
 
    /* force it to fail */
    if (cJSON_PrintPreallocated(root, buf_fail, (int)len_fail, 1)) {
        printf("cJSON_PrintPreallocated failed to show error with insufficient memory!\n");
        printf("cJSON_Print result:\n%s\n", out);
        printf("cJSON_PrintPreallocated result:\n%s\n", buf_fail);
        free(out);
        free(buf_fail);
        free(buf);
        return -1;
    }
 
    free(out);
    free(buf_fail);
    free(buf);
    return 0;
}复制