JSON.ARRPOP - Amazon ElastiCache

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

JSON.ARRPOP

Menghapus dan mengembalikan elemen pada indeks dari array. Popping array kosong akan menampilkan null.

Sintaks

JSON.ARRPOP <key> [path [index]]

  • kunci (wajib) - Kunci Valkey atau Redis OSS dari jenis JSON dokumen.

  • path (opsional) - Sebuah JSON jalan. Diatur secara default ke root jika tidak disediakan.

  • indeks (opsional) – Posisi dalam array tempat popping dimulai.

    • Default ke -1 jika tidak disediakan, yang berarti elemen terakhir.

    • Nilai negatif berarti posisi dari elemen terakhir.

    • Indeks di luar batas akan dibulatkan ke batas array masing-masing.

Nilai yang ditampilkan

Jika jalur adalah sintaksis yang ditingkatkan:

  • Array string massal yang merepresentasikan nilai yang di-popping di setiap jalur.

  • Jika nilai adalah array kosong, nilai yang akan dikembalikan adalah kosong.

  • Jika nilai bukan array, nilai yang akan dikembalikan adalah kosong.

Jika jalur adalah sintaksis terbatas:

  • String massal, yang mewakili JSON nilai yang muncul.

  • Null jika array kosong.

  • Kesalahan WRONGTYPE jika nilai di jalur bukan array.

Contoh

Sintaksis jalur yang ditingkatkan:

127.0.0.1:6379> JSON.SET k1 . '[[], ["a"], ["a", "b"]]'
OK
127.0.0.1:6379> JSON.ARRPOP k1 $[*]
1) (nil)
2) "\"a\""
3) "\"b\""
127.0.0.1:6379> JSON.GET k1
"[[],[],[\"a\"]]"

Sintaksis jalur terbatas:

127.0.0.1:6379> JSON.SET k1 . '[[], ["a"], ["a", "b"]]'
OK
127.0.0.1:6379> JSON.ARRPOP k1
"[\"a\",\"b\"]"
127.0.0.1:6379> JSON.GET k1
"[[],[\"a\"]]"

127.0.0.1:6379> JSON.SET k2 . '[[], ["a"], ["a", "b"]]'
OK
127.0.0.1:6379> JSON.ARRPOP k2 . 0
"[]"
127.0.0.1:6379> JSON.GET k2
"[[\"a\"],[\"a\",\"b\"]]"