本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
修剪路徑上的陣列,使其成為子陣列 [start, end],都包含在內。
如果陣列是空的,不必做任何事,會傳回 0。
如果開頭 <0,則將其視為 0。
如果結尾 >= 大小 (陣列的大小),則將其視為 size-1。
如果開頭 >= 大小或開頭 > 結尾,清空陣列並傳回 0。
語法
JSON.ARRTRIM <key> <path> <start> <end>
key (必要) – JSON 文件類型的 Valkey 或 Redis OSS 金鑰。
path (必要) – JSON 路徑。
start (必要) – 開頭索引,包含。
end (必要) – 結束索引,包含。
傳回
如果路徑是增強型語法:
整數陣列代表每個路徑的新陣列長度。
-
如果值是空陣列,其相應的傳回值為 null。
-
如果值不是陣列,其相應的傳回值為 null。
-
如果索引引數超出範圍,會發生
OUTOFBOUNDARIES
錯誤。
如果路徑是受限語法:
整數,新陣列長度。
如果陣列是空的,則為 null。
-
如果路徑上的值不是陣列,會發生
WRONGTYPE
錯誤。 -
如果索引引數超出範圍,會發生
OUTOFBOUNDARIES
錯誤。
範例
增強型路徑語法:
127.0.0.1:6379> JSON.SET k1 . '[[], ["a"], ["a", "b"], ["a", "b", "c"]]'
OK
127.0.0.1:6379> JSON.ARRTRIM k1 $[*] 0 1
1) (integer) 0
2) (integer) 1
3) (integer) 2
4) (integer) 2
127.0.0.1:6379> JSON.GET k1
"[[],[\"a\"],[\"a\",\"b\"],[\"a\",\"b\"]]"
受限路徑語法:
127.0.0.1:6379> JSON.SET k1 . '{"children": ["John", "Jack", "Tom", "Bob", "Mike"]}'
OK
127.0.0.1:6379> JSON.ARRTRIM k1 .children 0 1
(integer) 2
127.0.0.1:6379> JSON.GET k1 .children
"[\"John\",\"Jack\"]"