ZRANGEBYSCORE

Synopsis

ZRANGEBYSCORE key min max [WITHSCORES] [LIMIT offset count]
This command fetches members for which score is in the given min max range. min and max are doubles. If key does not exist, an empty range is returned. If key corresponds to a non sorted-set, an error is raised. Special bounds -inf and +inf are also supported to retrieve an entire range. min and max are inclusive unless they are prefixed with (, in which case they are exclusive.

Return value

Returns a list of members found in the range specified by min, max, unless the WITHSCORES option is specified (see below).

ZRANGEBYSCORE options

WITHSCORES: Makes the command return both the `member` and its `score`.

LIMIT offset count: Get a range of the matching elements starting at `offset` up to `count` elements, where `offset` is 0 indexed.

Examples

You can do this as shown below.

(integer) 2

Retrieve all members.

1) "v1"
2) "v2"

Retrieve all member score pairs.

1) "v1"
2) "1.0"
3) "v2"
4) "2.0"

Bounds are inclusive.

1) "v1"
2) "v2"

Bounds are exclusive.

(empty list or set)

Enforce a limit.

1) "v2"

See also

zadd, zcard, zrange, zrem, zrevrange