ZCARD(3valkey)

📦
version 9.0.6 · 2 versions
, in fedora 44

✨ ZCARD — the vibe check for your sorted set 💅

okay bestie, welcome to the ZCARD page of the Valkey Command Manual, section 3valkey. this one is short, sweet, and honestly iconic. no notes. 🎀

🌸 NAME 🌸

zcard — returns the number of members in a sorted set. that's it. that's the whole job. she does one thing and she slays it. ✨

🦋 SYNOPSIS 🦋

ZCARD key

💖 DESCRIPTION 💖

so basically, ZCARD hands you back the sorted set cardinality — which is just a fancy way of saying the number of elements — of the sorted set that's chillin' at key. count 'em up, bestie, that's the whole command. 💅

🫶 REPLY 🫶

per valkey-protocol(7), you get an Integer reply: the cardinality (aka the number of members) of that sorted set. and if the key doesn't exist? you get 0. no drama, no error, just a polite little zero. 🍓

⭐ COMPLEXITY ⭐

O(1) — constant time, babes. instant. she doesn't even break a sweat. 🔥

👑 ACL CATEGORIES 👑

  • @fast
  • @read
  • @sortedset

🌈 HISTORY 🌈

  • Available since: 1.2.0 — a true veteran, been serving looks since forever. 💜

🧚 EXAMPLES 🧚

127.0.0.1:6379> ZADD myzset 1 "one"
(integer) 1
127.0.0.1:6379> ZADD myzset 2 "two"
(integer) 1
127.0.0.1:6379> ZCARD myzset
(integer) 2

look at her go. added two members, asked for the count, got 2. main character energy fr fr. ✨

💀 SEE ALSO 💀

and that's the tea, bestie 🫖 this page is from Valkey version 9.0.0, dated 2025-10-21. go forth and count your members. periodt. 💅✨🎀

📦 where this page comes from