ZCOUNT

Syntax text Syntax diagram API methods

ZCOUNT key min max

Client:

zcount(
    name: KeyT,
    min: ZScoreBoundT,
    max: ZScoreBoundT
) → ResponseT

ZCOUNT(
    key: RedisArgument,
    min: number | RedisArgument,
    max: number | RedisArgument
) → Any

zcount(
    key: byte[],
    min: double,
    max: double
) → long  // BLPOP returns a two-elements array via a multi bulk reply in order to return both the unblocking key and the popped value. When a non-zero timeout is specified, and the BLPOP operation timed out, the return value is a nil multi bulk reply. Most connection values will return false or nil accordingly to the programming language used.

zcount(
    key: byte[],
    min: byte[],
    max: byte[]
) → long  // BLPOP returns a two-elements array via a multi bulk reply in order to return both the unblocking key and the popped value. When a non-zero timeout is specified, and the BLPOP operation timed out, the return value is a nil multi bulk reply. Most connection values will return false or nil accordingly to the programming language used.

zcount(
    key: String,
    min: double,
    max: double
) → long  // BLPOP returns a two-elements array via a multi bulk reply in order to return both the unblocking key and the popped value. When a non-zero timeout is specified, and the BLPOP operation timed out, the return value is a nil multi bulk reply. Most connection values will return false or nil accordingly to the programming language used.

zcount(
    key: String,
    min: String,
    max: String
) → long  // BLPOP returns a two-elements array via a multi bulk reply in order to return both the unblocking key and the popped value. When a non-zero timeout is specified, and the BLPOP operation timed out, the return value is a nil multi bulk reply. Most connection values will return false or nil accordingly to the programming language used.

zcount(
    key: K,  // the key.
    min: double,
    max: double
) → Long  // Long integer-reply the number of elements in the specified score range. @since 4.3

zcount(
    key: K,  // the key.
    min: String,
    max: String
) → Long  // Long integer-reply the number of elements in the specified score range. @since 4.3

zcount(
    key: K,  // the key.
    range: Range<? extends Number>  // the range.
) → Long  // Long integer-reply the number of elements in the specified score range. @since 4.3

zcount(
    key: K,  // the key.
    min: double,
    max: double
) → RedisFuture<Long>  // Long integer-reply the number of elements in the specified score range. @since 4.3

zcount(
    key: K,  // the key.
    min: String,
    max: String
) → RedisFuture<Long>  // Long integer-reply the number of elements in the specified score range. @since 4.3

zcount(
    key: K,  // the key.
    range: Range<? extends Number>  // the range.
) → RedisFuture<Long>  // Long integer-reply the number of elements in the specified score range. @since 4.3

zcount(
    key: K,  // the key.
    min: double,
    max: double
) → Mono<Long>  // Long integer-reply the number of elements in the specified score range. @since 4.3

zcount(
    key: K,  // the key.
    min: String,
    max: String
) → Mono<Long>  // Long integer-reply the number of elements in the specified score range. @since 4.3

zcount(
    key: K,  // the key.
    range: Range<? extends Number>  // the range.
) → Mono<Long>  // Long integer-reply the number of elements in the specified score range. @since 4.3

ZCount(
    ctx: context.Context,
    key: Any,
    min: Any,
    max: string
) → *IntCmd

zcount(
    $key: string,
    $min: int|string,
    $max: int|string
) → int

zcount(
    key: K,
    min: M,
    max: MM
) → (usize)

zcount(
    key: K,
    min: M,
    max: MM
) → (usize)

Available since:: Redis Open Source 2.0.0
Time complexity:: O(log(N)) with N being the number of elements in the sorted set.
ACL categories:: @read, @sortedset, @fast,
Compatibility:: Redis Software and Redis Cloud compatibility

Returns the number of elements in the sorted set at key with a score between min and max.

The min and max arguments have the same semantic as described for ZRANGEBYSCORE.

Note: the command has a complexity of just O(log(N)) because it uses elements ranks (see ZRANK) to get an idea of the range. Because of this there is no need to do a work proportional to the size of the range.

Required arguments

key

The name of the key that holds the sorted set.

min

The minimum score. The bound is inclusive unless prefixed with (. Use -inf for no lower bound.

max

The maximum score. The bound is inclusive unless prefixed with (. Use +inf for no upper bound.

Examples

Redis Software and Redis Cloud compatibility

Redis Software	Redis Cloud	Notes
✅ Standard ✅ Active-Active	✅ Standard ✅ Active-Active

Return information

RESP2 RESP3

Integer reply: the number of members in the specified score range.