JSON.STRAPPEND
Syntax
JSON.STRAPPEND key [path] 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-string
values to the string at path
Required arguments
key
is key to modify.
value
is value to append to one or more strings.
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.Optional arguments
path
is JSONPath to specify. Default is root $
.
Examples
redis> JSON.SET doc $ '{"a":"foo", "nested": {"a": "hello"}, "nested2": {"a": 31}}'
OK
redis> JSON.STRAPPEND doc $..a '"baz"'
1) (integer) 6
2) (integer) 8
3) (nil)
redis> JSON.GET doc $
"[{\"a\":\"foobaz\",\"nested\":{\"a\":\"hellobaz\"},\"nested2\":{\"a\":31}}]"
Return information
With $
-based path argument: Array reply of integer replies or null replies, where each element is the string's new length, or null
if the matching value is not a string.
With .
-based path argument: Integer reply representing the string's new length, or null reply if the matching value is not a string.
See also
JSON.ARRAPEND
| JSON.ARRINSERT