DECRBY(3valkey)

📦
version 9.0.6 · 2 versions
, in fedora 44

💖 DECRBY 💖

okay so bestie, we're in the valkey command manual (section 3, the library-functions girlies), and today's main character is DECRBY. she takes a number and she takes it down. that's it. that's the vibe. ✨

🌸 NAME 🌸

decrby — decrements a number from the integer value of a key. and if the key doesn't exist yet? no worries, she uses 0 as the initial value. starting from zero, living her truth. 💅

🎀 SYNOPSIS 🎀

DECRBY key decrement

✨ DESCRIPTION ✨

so what she does is: she takes the number stored at key and she decrements it by decrement. simple. iconic. no cap.

if the key does not exist, she sets it to 0 first and then does the operation. like, she's not gonna show up to a party with no outfit, she builds the fit from scratch. 🫶

but bestie, listen — an error gets returned if the key holds a value of the wrong type, or if it holds a string that can not be represented as integer. she's not a miracle worker, she's a number girlie. 😭

also, this operation is limited to 64 bit signed integers. know your limits, love yourself. 💀

and hey — go peek at INCR if you want the extra tea on increment/decrement operations in general. iykyk. 👑

💬 REPLY 💬

valkey-protocol(7) Integer reply: the value of the key after decrementing it. so she tells you where she landed. she's transparent like that. ✨

🦋 COMPLEXITY 🦋

O(1) — constant time, baby. instant. no waiting, no loading screen, she ate and left no crumbs. 🔥

👑 ACL CATEGORIES 👑

  • @fast
  • @string
  • @write

🌈 HISTORY 🌈

  • Available since: 1.0.0 — an OG, a legend, been here since day one. ⭐

🍓 EXAMPLES 🍓

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

like. 10 minus 3 is 7. she did the math, she showed the receipts, she slayed. 💖

💜 SEE ALSO 💜

the whole friend group fr fr, go say hi. 🧚

okay that's the whole page bestie!! this was version 9.0.0, dated 2025-10-21, and it lives under DECRBY(3valkey). go forth and decrement responsibly. mwah. 💋 periodt. ✨🎀🦋💅

📦 where this page comes from