INCRBY(3valkey)

📦
version 9.0.6 · 2 versions
, in fedora 44

💖 INCRBY — the "add a number to my key" command (from the valkey(3valkey) manual) 💖

okay bestie, listen. this is incrby from the Valkey Command Manual and it is literally the glow-up command. it bumps the integer value of a key by a number, and if the key doesn't exist yet it just starts from 0 like a fresh little baby. iconic behaviour honestly. ✨

🌸 SYNOPSIS 🌸

INCRBY key increment

that's it. that's the whole vibe. two args and you're done. 🫶

🎀 DESCRIPTION 🎀

so here's the tea: INCRBY increments the number stored at key by increment. 💅

if the key does not exist, it gets set to 0 first and then the operation happens. so yes, your first INCRBY on a brand-new key is basically a SET, but make it math. 🧮✨

⚠️ bestie. pay attention. 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. so don't go throwing "hello kitty" in there and expecting arithmetic. she will not do it. 💀

also, this operation is limited to 64 bit signed integers. that's the ceiling, that's the floor, that's the whole apartment. don't come crying when you overflow it. 🙈

oh and ps — go read INCR if you want the extra information on increment/decrement operations. the girlies who know, know. 👑

🌈 REPLY 🌈

valkey-protocol(7) Integer reply: the value of the key after the increment. so you get the glow-up result, not the old dusty number. ⭐

💜 COMPLEXITY 💜

O(1)

constant time. no notes. she's fast, she's efficient, she's serving. 🔥

✨ ACL CATEGORIES ✨

  • @fast
  • @string
  • @write

three little badges, all of them slaying. 🎀

🦋 HISTORY 🦋

  • Available since: 1.0.0

a literal elder. been here since the beginning and still eating. 👑

🍓 EXAMPLES 🍓

watch her work:

127.0.0.1:6379> SET mykey "10"
OK
127.0.0.1:6379> INCRBY mykey 5
(integer) 15

10 + 5 = 15. math is mathing. the key said "not me levelling up in public". 😭💖

👑 SEE ALSO 👑

the whole friend group. go say hi. 🫶✨

and that's the page bestie!! this was Valkey 9.0.0, dated 2025-10-21, and the manual name is INCRBY(3valkey) — remember her name because she will be on the test. 💅🌸 mwah, go increment something. 🎀

📦 where this page comes from