What's new in Valkey 9.0? Discover new features and improvements. Read the announcement.

DECRBY

Decrements the integer value of a key by a number. Uses 0 as initial value if the key doesn't exist.

Usage
DECRBY key decrement
Complexity
O(1)
Since
1.0.0
ACL Categories
@fast, @string, @write
Command flags
WRITE, DENYOOM, FAST

Decrements the number stored at key by decrement. If the key does not exist, it is set to 0 before performing the operation. An error is returned if the key contains a value of the wrong type or contains a string that can not be represented as integer. This operation is limited to 64 bit signed integers.

See INCR for extra information on increment/decrement operations.

Examples

127.0.0.1:6379> SET mykey "10"
OK
127.0.0.1:6379> DECRBY mykey 3
(integer) 7

Replies

RESP2

Integer reply: the value of the key after decrementing it.

RESP3

Integer reply: the value of the key after decrementing it.