decrby.3valkey - Man Page

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

Synopsis

DECRBY key decrement

Description

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.

Reply

valkey-protocol(7) Integer reply: the value of the key after decrementing it.

Complexity

O(1)

Acl Categories

@fast @string @write

History

Examples

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

See Also

append(3valkey), decr(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)

Info

2024-09-23 8.0.0 Valkey Command Manual