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 文档许可。