清空JSON对象或数组 - JsonClear

函数简介

清空JSON对象中的所有属性或JSON数组中的所有元素。

接口名称

JsonClear

DLL调用

int JsonClear(long obj)

参数说明

参数名类型说明
obj长整数型JSON对象或数组句柄

示例

// 清空JSON对象
long jsonObj = JsonParse("{\"name\":\"test\",\"age\":25,\"city\":\"beijing\"}", 0);

// 清空对象
int result = JsonClear(jsonObj);
if (result == 0) {
    printf("清空对象成功\n");
}

// 查看清空后的结果
int err = 0;
const char* jsonStr = JsonStringify(jsonObj, 2, &err);
if (jsonStr != 0 && err == 0) {
    printf("清空后的JSON: %s\n", jsonStr);
    FreeStringPtr(jsonStr);
}

// 清空JSON数组
long jsonArr = JsonParse("[1,2,3,4,5]", 0);
JsonClear(jsonArr);

JsonFree(jsonObj);
JsonFree(jsonArr);

返回值

返回操作结果错误码，0表示成功

错误码说明

错误码说明
JSON_SUCCESS (0)操作成功
JSON_ERROR_INVALID_HANDLE (1)无效的句柄
JSON_ERROR_PARSE_FAILED (2)JSON解析失败
JSON_ERROR_TYPE_MISMATCH (3)类型不匹配
JSON_ERROR_KEY_NOT_FOUND (4)键不存在
JSON_ERROR_INDEX_OUT_OF_RANGE (5)索引超出范围
JSON_ERROR_UNKNOWN (6)未知错误

注意事项

  • 清空后，所有子元素都会被释放
  • 清空操作不可逆
  • 适用于对象和数组类型
Last Updated: