decr.3valkey - Man Page
Decrements the integer value of a key by one. Uses 0 as initial value if the key doesn’t exist.
Synopsis
DECR
key
Description
Decrements the number stored at key
by one. 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.
Reply
valkey-protocol(7) Integer reply: the value of the key after decrementing it.
Complexity
O(1)
Acl Categories
@fast @string @write
History
- Available since: 1.0.0
Examples
127.0.0.1:6379> SET mykey "10" OK 127.0.0.1:6379> DECR mykey (integer) 9 127.0.0.1:6379> SET mykey "234293482390480948029348230948" OK 127.0.0.1:6379> DECR mykey (error) ERR value is not an integer or out of range
See Also
append(3valkey), decrby(3valkey), get(3valkey), getdel(3valkey), getex(3valkey), getrange(3valkey), incr(3valkey), incrby(3valkey), incrbyfloat(3valkey), lcs(3valkey), mget(3valkey), mset(3valkey), msetnx(3valkey), set(3valkey), setrange(3valkey), strlen(3valkey)