SSCAN(3valkey)

📦
version 9.0.6 · 2 versions
, in fedora 44

✨ SSCAN (aka the glow-up guide from the valkey manual, bestie) ✨

okay so real talk, we're in the Valkey Command Manual and today's main character is sscan 💅

🎀 NAME 🎀

sscan — it iterates over members of a set. that's it, that's the whole job, and it does it flawlessly ✨

🌸 SYNOPSIS 🌸

SSCAN key cursor [MATCH pattern] [COUNT count]
ngl bestie, this page is short on purpose: See SCAN for SSCAN documentation. the full lore lives over there, go read it, iykyk 🫶

💖 REPLY 💖

so when you call this, valkey-protocol(7) hands you back an Array reply 🎁 — and specifically, an array with exactly two elements:

  • the first element is a valkey-protocol(7) Bulk string reply that represents an unsigned 64-bit number — that's your cursor, bestie, hold onto it 🫴
  • the second element is a valkey-protocol(7) Array reply with the names of the scanned members 👑

🦋 COMPLEXITY 🦋

  • O(1) for every single call — like, per-call it's basically free 💸
  • O(N) for a complete iteration, including enough command calls for the cursor to return back to 0 🔁
  • and N here is the number of elements inside the collection, no cap 📏

💅 ACL CATEGORIES 💅

@read @set @slow

three little tags, all iconic, all necessary 👑

⭐ HISTORY ⭐

  • Available since: 2.8.0 — yeah she's been around a minute, a true veteran 🫡

🌈 SEE ALSO 🌈

the whole squad, fr fr — go show them love too:

and that's the whole page bestie, tysm for reading, you ate 💖 this was brought to you by version 9.0.0, dated 2025-10-21 — go forth and SSCAN responsibly, mwah 💋🎀✨

📦 where this page comes from