Skip to content
HotKVDocs

Ask the HotKV docs

Answers come only from these docs and can be wrong; check the linked pages before you rely on them.

DECR

Last updated 
DECR key
Group
String
Complexity
O(1)
Arity
2 (exactly, counting the command name)
Flags
write, fast
Keys
first 1, last 1, step 1
HotKV Cloud
All plans
On-Premise
no license needed

DECR subtracts 1 from the number stored at key and returns the new value. A missing key counts as 0, so the first DECR creates it with -1. The value must be the decimal text of a signed 64-bit integer, and the key keeps its time to live.

Return value

Section titled “Return value”
Case RESP2 RESP3
Always Integer: the value after the decrement Integer

Errors:

  • ERR value is not an integer or out of range when the stored value is not an integer.
  • ERR increment or decrement would overflow when the result does not fit in a signed 64-bit integer.
  • WRONGTYPE when the key holds a value that is not a string.

Examples

Section titled “Examples”
127.0.0.1:6379> SET stock 3
OK
127.0.0.1:6379> DECR stock
(integer) 2
127.0.0.1:6379> DECR fresh
(integer) -1

Compatibility

Section titled “Compatibility”

Same as Redis 7 and Valkey 8.

See also

Section titled “See also”

DECRBY, INCR, INCRBY