summaryrefslogtreecommitdiffstats
path: root/iredis/data/commands/rpop.md
diff options
context:
space:
mode:
Diffstat (limited to 'iredis/data/commands/rpop.md')
-rw-r--r--iredis/data/commands/rpop.md21
1 files changed, 17 insertions, 4 deletions
diff --git a/iredis/data/commands/rpop.md b/iredis/data/commands/rpop.md
index 9c03902..6233c03 100644
--- a/iredis/data/commands/rpop.md
+++ b/iredis/data/commands/rpop.md
@@ -1,16 +1,29 @@
-Removes and returns the last element of the list stored at `key`.
+Removes and returns the last elements of the list stored at `key`.
+
+By default, the command pops a single element from the end of the list. When
+provided with the optional `count` argument, the reply will consist of up to
+`count` elements, depending on the list's length.
@return
+When called without the `count` argument:
+
@bulk-string-reply: the value of the last element, or `nil` when `key` does not
exist.
+When called with the `count` argument:
+
+@array-reply: list of popped elements, or `nil` when `key` does not exist.
+
+@history
+
+- `>= 6.2`: Added the `count` argument.
+
@examples
```cli
-RPUSH mylist "one"
-RPUSH mylist "two"
-RPUSH mylist "three"
+RPUSH mylist "one" "two" "three" "four" "five"
RPOP mylist
+RPOP mylist 2
LRANGE mylist 0 -1
```