JSON.CLEAR
清除容器值(数组/对象)并将数值设置为0
语法
JSON.CLEAR key [path]
引入版本:2.0.0
复杂度摘要:O(N)
清除容器值(数组/对象)并将数值设置为0
必需参数
key
解析的关键。
可选参数
path
是JSONPath来指定。默认为根 $。不存在的路径将被忽略。
[!注意]
对于空容器和零号,已清除的值将被忽略。
示例
Clear container values and set numeric values to 0
创建 JSON 文档。
redis> JSON.SET doc $ '{"obj":{"a":1, "b":2}, "arr":[1,2,3], "str": "foo", "bool": true, "int": 42, "float": 3.14}' OK
清除所有容器值。这将返回具有清除值的对象的数量。
redis> JSON.CLEAR doc $.* (整数) 4
获取更新的文档。请注意,数值已设置为 0。
redis> JSON.GET doc $ "[{\"obj\":{},\"arr\":[],\"str\":\"foo\",\"bool\":true,\"int\":0,\"float\":0}]"
Redis Software 与 Redis Cloud 兼容性
| Redis 软件 |
Redis Cloud |
说明 |
|---|---|---|
| ✅ 支持 |
✅ 灵活且每年一次 ✅ 免费和固定 |
返回值
RESP2
整数回复:清除的匹配 JSON 数组和对象的数量加上归零的匹配 JSON 数值的数量。
RESP3
整数回复:清除的匹配 JSON 数组和对象的数量加上归零的匹配 JSON 数值的数量。
参见
JSON.ARRINDEX | JSON.ARRINSERT
相关主题
资料来源:Redis 官方 JSON.CLEAR 文档;中文内容参考 Redis 文档许可。