Skip to content
HotKVDocs

Ask the HotKV docs

Answers come only from these docs and can be wrong; check the linked pages before you rely on them.

ZCOUNT

Last updated 
ZCOUNT key min max
Group
Sorted set
Complexity
O(log(N)) where N is the size of the sorted set
Arity
4 (exactly, counting the command name)
Flags
read-only, fast
Keys
first 1, last 1, step 1
HotKV Cloud
All plans
On-Premise
no license needed

ZCOUNT returns how many members of the sorted set at key have a score between min and max.

Both bounds are inclusive by default. Prefix a bound with ( to make it exclusive, and use -inf and +inf for an open end. For example, ZCOUNT key (1 5 counts scores greater than 1 and at most 5.

Return value

Section titled “Return value”
Case RESP2 RESP3
Success Integer: the number of members in the range Same
Key does not exist Integer 0 Same

Errors:

  • ERR min or max is not a float if a bound is not a number. The bounds are checked before the key is looked up.
  • WRONGTYPE if key holds a value that is not a sorted set.

Examples

Section titled “Examples”
127.0.0.1:6379> ZADD board 1 "a" 2 "b" 3 "c" 4 "d"
(integer) 4
127.0.0.1:6379> ZCOUNT board 2 3
(integer) 2
127.0.0.1:6379> ZCOUNT board (2 +inf
(integer) 2
127.0.0.1:6379> ZCOUNT board -inf +inf
(integer) 4

Compatibility

Section titled “Compatibility”

Same as Redis 7.4 and Valkey 8.

See also

Section titled “See also”

ZRANGEBYSCORE, ZLEXCOUNT, ZCARD, ZREMRANGEBYSCORE