JSON.ARRTRIM - Amazon ElastiCache

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

JSON.ARRTRIM

修剪路徑上的陣列,使其成為子陣列 [start, end],都包含在內。

  • 如果陣列是空的,不必做任何事,會傳回 0。

  • 如果開頭 <0,則將其視為 0。

  • 如果結尾 >= 大小 (陣列的大小),則將其視為 size-1。

  • 如果開頭 >= 大小或開頭 > 結尾,清空陣列並傳回 0。

語法

JSON.ARRINSERT <key> <path> <start> <end>
  • 金鑰 (必要) – JSON 文件類型的 Valkey 或 Redis OSS金鑰。

  • 路徑 (必要) – 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\"]"