Skip to content

Latest commit

 

History

History
68 lines (43 loc) · 2.27 KB

json.arrappend.md

File metadata and controls

68 lines (43 loc) · 2.27 KB

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

Examples

Required arguments

key

is key to modify.

value

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

{{% alert title="About using strings with JSON commands" color="warning" %}} 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. {{% /alert %}}

Optional arguments

path

is JSONPath to specify. Default is root $.

Return value

JSON.ARRAPEND returns an array of integer replies for each path, the array's new size, or nil, if the matching JSON value is not an array. For more information about replies, see Redis serialization protocol specification.

Examples

Add a new color to a list of product colors

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

{{< highlight bash >}} 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 {{< / highlight >}}

Add color blue to the end of the colors array. JSON.ARRAPEND returns the array's new size.

{{< highlight bash >}} redis> JSON.ARRAPPEND item:1 $.colors '"blue"'

  1. (integer) 3 {{< / highlight >}}

Return the new length of the colors array.

{{< highlight bash >}} redis> JSON.GET 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","blue"]}" {{< / highlight >}}

See also

JSON.ARRINDEX | JSON.ARRINSERT

Related topics