获取JSON对象中的字符串值 - JsonGetString
函数简介
获取JSON对象中指定键对应的字符串值。
接口名称
JsonGetString
DLL调用
long JsonGetString(long obj, string key, int* err)
参数说明
参数名 | 类型 | 说明 |
---|---|---|
obj | 长整数型 | JSON对象句柄 |
key | 字符串 | 键名 |
err | 整数型指针 | 错误码输出参数,可为0 |
示例
// 获取JSON对象中的字符串值
long jsonObj = JsonParse("{\"name\":\"test\",\"message\":\"hello world\"}", 0);
int err = 0;
const char* name = JsonGetString(jsonObj, "name", &err);
if (name != 0 && err == 0) {
printf("name: %s\n", name);
FreeStringPtr(name); // 释放字符串内存
}
JsonFree(jsonObj); // 释放JSON对象
返回值
返回字符串值,需调用FreeStringPtr释放,失败时返回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) | 未知错误 |
注意事项
- 返回的字符串需要调用FreeStringPtr释放内存
- 如果键不存在或值不是字符串类型,返回0
- 错误码通过err参数返回