8fb13ce8 |
1 | |
2 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> |
3 | <html> |
4 | <head> |
5 | <link type="text/css" rel="stylesheet" href="style.css" /> |
6 | </head> |
7 | <body> |
8 | <div id="page"> |
9 | |
10 | <div id='header'> |
11 | <a href="index.html"> |
12 | <img style="border:none" alt="Redis Documentation" src="redis.png"> |
13 | </a> |
14 | </div> |
15 | |
16 | <div id="pagecontent"> |
17 | <div class="index"> |
18 | <!-- This is a (PRE) block. Make sure it's left aligned or your toc title will be off. --> |
ab72b483 |
19 | <b>LrangeCommand: Contents</b><br> <a href="#LRANGE _key_ _start_ _end_">LRANGE _key_ _start_ _end_</a><br> <a href="#Consistency with range functions in various programming languages">Consistency with range functions in various programming languages</a><br> <a href="#Out-of-range indexes">Out-of-range indexes</a><br> <a href="#Return value">Return value</a> |
8fb13ce8 |
20 | </div> |
21 | |
22 | <h1 class="wikiname">LrangeCommand</h1> |
23 | |
24 | <div class="summary"> |
25 | |
26 | </div> |
27 | |
28 | <div class="narrow"> |
29 | #sidebar <a href="ListCommandsSidebar.html">ListCommandsSidebar</a><h1><a name="LRANGE _key_ _start_ _end_">LRANGE _key_ _start_ _end_</a></h1> |
ab72b483 |
30 | <i>Time complexity: O(start+n) (with n being the length of the range and start being the start offset)</i>Return the specified elements of the list stored at the specified |
31 | key. Start and end are zero-based indexes. 0 is the first element |
32 | of the list (the list head), 1 the next element and so on.<br/><br/>For example LRANGE foobar 0 2 will return the first three elements |
33 | of the list.<br/><br/><i>start</i> and <i>end</i> can also be negative numbers indicating offsets |
34 | from the end of the list. For example -1 is the last element of |
35 | the list, -2 the penultimate element and so on.<h2><a name="Consistency with range functions in various programming languages">Consistency with range functions in various programming languages</a></h2>Note that if you have a list of numbers from 0 to 100, LRANGE 0 10 will return |
36 | 11 elements, that is, rightmost item is included. This <b>may or may not</b> be consistent with |
37 | behavior of range-related functions in your programming language of choice (think Ruby's Range.new, Array#slice or Python's range() function).<br/><br/>LRANGE behavior is consistent with one of Tcl.<h2><a name="Out-of-range indexes">Out-of-range indexes</a></h2>Indexes out of range will not produce an error: if start is over |
38 | the end of the list, or start <code name="code" class="python">></code> end, an empty list is returned. |
39 | If end is over the end of the list Redis will threat it just like |
40 | the last element of the list.<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 range. |
8fb13ce8 |
41 | </div> |
42 | |
43 | </div> |
44 | </div> |
45 | </body> |
46 | </html> |
47 | |