Redis DECRBY Command

Redis Strings (string)

The Redis DECRBY command subtracts the specified decrement amount from the value stored at the key.

If the key does not exist, the key's value will be initialized to 0 first, and then the DECRBY operation will be executed.

If the value contains an incorrect type, or if the string type value cannot be represented as a number, an error is returned.

The value of this operation is limited to 64 Within the range of signed numbers represented by bits.

Syntax

Basic Syntax of Redis DECRBY Command

redis 127.0.0.1:6379> DECRBY KEY_NAME DECREMENT_AMOUNT

Available Versions

>= 1.0.0

Return Value

The value of the key after subtracting the specified decrement amount.

Online Examples

# Decrement the value of an existing key
redis> SET count 100
OK
redis> DECRBY count 20
(integer) 80
# Decrement the value of a non-existing key
redis> EXISTS pages
(integer) 0
redis> DECRBY pages 10
(integer) -10

Redis Strings (string)