设置JSON对象中的字符串值 - JsonSetString
函数简介
设置JSON对象中指定键的字符串值。
接口名称
JsonSetString
DLL调用
int JsonSetString(long obj, string key, string value)
参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| obj | 长整数型 | JSON对象句柄 |
| key | 字符串 | 键名 |
| value | 字符串 | 字符串值 |
示例
// 设置JSON对象中的字符串值
long jsonObj = JsonCreateObject();
// 设置基本字符串
int result = JsonSetString(jsonObj, "name", "test");
if (result == 0) {
printf("设置字符串成功\n");
}
// 设置包含特殊字符的字符串
JsonSetString(jsonObj, "message", "Hello \"World\"");
JsonSetString(jsonObj, "path", "C:\\Program Files\\App");
// 序列化查看结果
int err = 0;
const char* jsonStr = JsonStringify(jsonObj, 2, &err);
if (jsonStr != 0 && err == 0) {
printf("JSON: %s\n", jsonStr);
FreeStringPtr(jsonStr);
}
JsonFree(jsonObj);
返回值
返回操作结果错误码，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) | 未知错误 |
注意事项
- 如果key已存在，会覆盖原有值
- 支持包含特殊字符的字符串（会自动转义）
- 字符串值会被正确转义为JSON格式