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)