ZRANGEBYSCORE
Attention
This page is from an older version. Click here to go the latest version.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
member and its score.offset up to count
elements, where offset is 0 indexed.Examples
You can do this as shown below.
$ ZADD z_key 1.0 v1 2.0 v2
(integer) 2
Retrieve all members.
$ ZRANGEBYSCORE z_key -inf +inf
1) "v1"
2) "v2"
Retrieve all member score pairs.
$ ZRANGEBYSCORE z_key -inf +inf WITHSCORES
1) "v1"
2) "1.0"
3) "v2"
4) "2.0"
Bounds are inclusive.
$ ZRANGEBYSCORE z_key 1.0 2.0
1) "v1"
2) "v2"
Bounds are exclusive.
$ ZRANGEBYSCORE z_key (1.0 (2.0
(empty list or set)
Enforce a limit.
ZRANGEBYSCORE z_key -inf +inf LIMIT 1 1
1) "v2"