summaryrefslogtreecommitdiffstats
path: root/iredis/data/commands/lrange.md
diff options
context:
space:
mode:
Diffstat (limited to 'iredis/data/commands/lrange.md')
-rw-r--r--iredis/data/commands/lrange.md27
1 files changed, 15 insertions, 12 deletions
diff --git a/iredis/data/commands/lrange.md b/iredis/data/commands/lrange.md
index 923b542..7634f3e 100644
--- a/iredis/data/commands/lrange.md
+++ b/iredis/data/commands/lrange.md
@@ -1,24 +1,27 @@
-Returns the specified elements of the list stored at `key`. The offsets `start`
-and `stop` are zero-based indexes, with `0` being the first element of the list
-(the head of the list), `1` being the next element and so on.
+Returns the specified elements of the list stored at `key`.
+The offsets `start` and `stop` are zero-based indexes, with `0` being the first
+element of the list (the head of the list), `1` being the next element and so
+on.
These offsets can also be negative numbers indicating offsets starting at the
-end of the list. For example, `-1` is the last element of the list, `-2` the
-penultimate, and so on.
+end of the list.
+For example, `-1` is the last element of the list, `-2` the penultimate, and so
+on.
## Consistency with range functions in various programming languages
Note that if you have a list of numbers from 0 to 100, `LRANGE list 0 10` will
-return 11 elements, that is, the rightmost item is included. This **may or may
-not** be consistent with behavior of range-related functions in your programming
-language of choice (think Ruby's `Range.new`, `Array#slice` or Python's
-`range()` function).
+return 11 elements, that is, the rightmost item is included.
+This **may or may not** be consistent with behavior of range-related functions
+in your programming language of choice (think Ruby's `Range.new`, `Array#slice`
+or Python's `range()` function).
## Out-of-range indexes
-Out of range indexes will not produce an error. If `start` is larger than the
-end of the list, an empty list is returned. If `stop` is larger than the actual
-end of the list, Redis will treat it like the last element of the list.
+Out of range indexes will not produce an error.
+If `start` is larger than the end of the list, an empty list is returned.
+If `stop` is larger than the actual end of the list, Redis will treat it like
+the last element of the list.
@return