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

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)

Info

2024-09-23 8.0.0 Valkey Command Manual