JSON.NUMINCRBY

Syntax

  1. JSON.NUMINCRBY key path value

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

Increment the number value stored at path by number

Examples

Required arguments

key

is key to modify.

value

is number value to increment.

Optional arguments

path

is JSONPath to specify. Default is root $.

Return

JSON.NUMINCRBY returns a bulk string reply specified as a stringified new value for each path, or nil, if the matching JSON value is not a number. For more information about replies, see Redis serialization protocol specification.

Examples

Increment number values

Create a document.

  1. dragonfly> JSON.SET doc . '{"a":"b","b":[{"a":2}, {"a":5}, {"a":"c"}]}'
  2. OK

Increment a value of a object by 2. The command fails to find a number and returns null.

  1. dragonfly> JSON.NUMINCRBY doc $.a 2
  2. "[null]"

Recursively find and increment a value of all a objects. The command increments numbers it finds and returns null for nonnumber values.

  1. dragonfly> JSON.NUMINCRBY doc $..a 2
  2. "[null,4,7,null]"

See also

JSON.ARRINDEX | JSON.ARRINSERT