cJSON_AddItemReferenceToArray使用说明

cJSON_AddItemReferenceToArray函数是cJSON库中的一个函数，用于将一个cJSON对象添加到一个cJSON数组中。该函数的声明如下：

void cJSON_AddItemReferenceToArray(cJSON *array, cJSON *item);

其中，参数`array`是要添加的目标数组，参数`item`是要添加到目标数组的cJSON对象。

需要注意的是，cJSON_AddItemReferenceToArray函数并不会创建新的cJSON对象，而是将已经存在的cJSON对象添加到目标数组中。因此，在调用该函数之前，需要先创建好要添加的cJSON对象。

使用该函数的示例如下：

cJSON *root, *array, *item;

// 创建一个空的JSON对象
root = cJSON_CreateObject();

// 创建一个JSON数组
array = cJSON_CreateArray();

// 创建一个JSON对象
item = cJSON_CreateObject();
cJSON_AddNumberToObject(item, "id", 123);
cJSON_AddStringToObject(item, "name", "John");

// 将该对象添加到数组中
cJSON_AddItemReferenceToArray(array, item);

// 将数组添加到JSON对象中
cJSON_AddItemToObject(root, "users", array);

// 将JSON对象转换为字符串输出
char *jsonString = cJSON_Print(root);
printf("%s\n", jsonString);

// 释放内存
cJSON_Delete(root);

在上面的示例中，我们首先创建了一个空的JSON对象`root`，然后创建了一个JSON数组`array`和一个JSON对象`item`，并向`item`中添加了两个属性。接下来，我们将`item`添加到`array`中，再将`array`添加到`root`中，并将`root`转换成字符串输出。最后，我们释放了创建的cJSON对象以释放内存。