JSON.ARRAPPEND

Syntax
JSON.ARRAPPEND key path value [value ...]
Available in:
Redis Open Source / JSON 1.0.0
Time complexity:
O(1) when path is evaluated to a single value, O(N) when path is evaluated to multiple values, where N is the size of the key
ACL categories:
@json, @write, @slow,

Append the JSON values into the array at path after the last element in it.

Examples

Required arguments

key

is the key to modify.

path

is the JSONPath to specify.

value

is one or more values to append to one or more arrays.

About using strings with JSON commands:
To specify a string as an array value to append, wrap the quoted string with an additional set of single quotes. Example: '"silver"'. For more detailed use, see Examples.

Examples

Add a new color to a list of product colors

Create a document for noise-cancelling headphones in black and silver colors.

redis> JSON.SET item:1 $ '{"name":"Noise-cancelling Bluetooth headphones","description":"Wireless Bluetooth headphones with noise-cancelling technology","connection":{"wireless":true,"type":"Bluetooth"},"price":99.98,"stock":25,"colors":["black","silver"]}'
OK

Add blue to the end of the colors array. JSON.ARRAPPEND returns the new length of the colors array.

redis> JSON.ARRAPPEND item:1 $.colors '"blue"'
1) (integer) 3

Get the updated value of the colors array.

redis> JSON.GET item:1 $.colors
"[[\"black\",\"silver\",\"blue\"]]"

Return information

With $-based path argument: Array reply of integer replies or null replies, where each element is the array's new length, or null if the matching value is not an array.

With .-based path argument: Integer reply representing the array's new length, or null reply if the matching value is not an array.

See also

JSON.ARRINDEX | JSON.ARRINSERT

RATE THIS PAGE
Back to top ↑