hincrby.3valkey - Man Page
Increments the integer value of a field in a hash by a number. Uses 0 as initial value if the field doesn’t exist.
Synopsis
HINCRBY
key field increment
Description
Increments the number stored at field
in the hash stored at key
by increment
. If key
does not exist, a new key holding a hash is created. If field
does not exist the value is set to 0
before the operation is performed.
The range of values supported by HINCRBY
is limited to 64 bit signed integers.
Reply
valkey-protocol(7) Integer reply: the value of the field after the increment operation.
Complexity
O(1)
Acl Categories
@fast @hash @write
History
- Available since: 2.0.0
Examples
Since the increment
argument is signed, both increment and decrement operations can be performed:
127.0.0.1:6379> HSET myhash field 5 (integer) 1 127.0.0.1:6379> HINCRBY myhash field 1 (integer) 6 127.0.0.1:6379> HINCRBY myhash field -1 (integer) 5 127.0.0.1:6379> HINCRBY myhash field -10 (integer) -5
See Also
hdel(3valkey), hexists(3valkey), hget(3valkey), hgetall(3valkey), hincrbyfloat(3valkey), hkeys(3valkey), hlen(3valkey), hmget(3valkey), hrandfield(3valkey), hscan(3valkey), hset(3valkey), hsetnx(3valkey), hstrlen(3valkey), hvals(3valkey)