diff options
Diffstat (limited to 'doc/ZrangebyscoreCommand.html')
-rw-r--r-- | doc/ZrangebyscoreCommand.html | 73 |
1 files changed, 73 insertions, 0 deletions
diff --git a/doc/ZrangebyscoreCommand.html b/doc/ZrangebyscoreCommand.html new file mode 100644 index 000000000..583e9303f --- /dev/null +++ b/doc/ZrangebyscoreCommand.html @@ -0,0 +1,73 @@ + +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> +<html> + <head> + <link type="text/css" rel="stylesheet" href="style.css" /> + </head> + <body> + <div id="page"> + + <div id='header'> + <a href="index.html"> + <img style="border:none" alt="Redis Documentation" src="redis.png"> + </a> + </div> + + <div id="pagecontent"> + <div class="index"> +<!-- This is a (PRE) block. Make sure it's left aligned or your toc title will be off. --> +<b>ZrangebyscoreCommand: Contents</b><br> <a href="#ZRANGEBYSCORE _key_ _min_ _max_ `[`LIMIT _offset_ _count_`]` (Redis >">ZRANGEBYSCORE _key_ _min_ _max_ `[`LIMIT _offset_ _count_`]` (Redis ></a><br> <a href="#ZRANGEBYSCORE _key_ _min_ _max_ `[`LIMIT _offset_ _count_`]` `[`WITHSCORES`]` (Redis >">ZRANGEBYSCORE _key_ _min_ _max_ `[`LIMIT _offset_ _count_`]` `[`WITHSCORES`]` (Redis ></a><br> <a href="#Exclusive intervals and infinity">Exclusive intervals and infinity</a><br> <a href="#Return value">Return value</a><br> <a href="#Examples">Examples</a> + </div> + + <h1 class="wikiname">ZrangebyscoreCommand</h1> + + <div class="summary"> + + </div> + + <div class="narrow"> + #sidebar <a href="SortedSetCommandsSidebar.html">SortedSetCommandsSidebar</a><h1><a name="ZRANGEBYSCORE _key_ _min_ _max_ `[`LIMIT _offset_ _count_`]` (Redis >">ZRANGEBYSCORE _key_ _min_ _max_ `[`LIMIT _offset_ _count_`]` (Redis ></a></h1> 1.1) = +<h1><a name="ZRANGEBYSCORE _key_ _min_ _max_ `[`LIMIT _offset_ _count_`]` `[`WITHSCORES`]` (Redis >">ZRANGEBYSCORE _key_ _min_ _max_ `[`LIMIT _offset_ _count_`]` `[`WITHSCORES`]` (Redis ></a></h1> 1.3.4) = +<i>Time complexity: O(log(N))+O(M) with N being the number of elements in the sorted set and M the number of elements returned by the command, so if M is constant (for instance you always ask for the first ten elements with LIMIT) you can consider it O(log(N))</i><blockquote>Return the all the elements in the sorted set at key with a score between_min_ and <i>max</i> (including elements with score equal to min or max).</blockquote> +<blockquote>The elements having the same score are returned sorted lexicographically asASCII strings (this follows from a property of Redis sorted sets and does notinvolve further computation).</blockquote> +<blockquote>Using the optional LIMIT it's possible to get only a range of the matchingelements in an SQL-alike way. Note that if <i>offset</i> is large the commandsneeds to traverse the list for <i>offset</i> elements and this adds up to theO(M) figure.</blockquote><h2><a name="Exclusive intervals and infinity">Exclusive intervals and infinity</a></h2> +<i>min</i> and <i>max</i> can be -inf and +inf, so that you are not required to know what's the greatest or smallest element in order to take, for instance, elements "up to a given value".<br/><br/>Also while the interval is for default closed (inclusive) it's possible to specify open intervals prefixing the score with a "(" character, so for instance: +<pre class="codeblock python" name="code"> +ZRANGEBYSCORE zset (1.3 5 +</pre> +Will return all the values with score <b>> 1.3 and <= 5</b>, while for instance: +<pre class="codeblock python python" name="code"> +ZRANGEBYSCORE zset (5 (10 +</pre> +Will return all the values with score <b>> 5 and < 10</b> (5 and 10 excluded). +<h2><a name="Return value">Return value</a></h2><a href="ReplyTypes.html">Multi bulk reply</a>, specifically a list of elements in the specified score range. +<h2><a name="Examples">Examples</a></h2> +<pre class="codeblock python python python" name="code"> +redis> zadd zset 1 foo +(integer) 1 +redis> zadd zset 2 bar +(integer) 1 +redis> zadd zset 3 biz +(integer) 1 +redis> zadd zset 4 foz +(integer) 1 +redis> zrangebyscore zset -inf +inf +1. "foo" +2. "bar" +3. "biz" +4. "foz" +redis> zrangebyscore zset 1 2 +1. "foo" +2. "bar" +redis> zrangebyscore zset (1 2 +1. "bar" +redis> zrangebyscore zset (1 (2 +(empty list or set) +</pre> + </div> + + </div> + </div> + </body> +</html> + |