What's new in Valkey 9.0? Discover new features and improvements. Read the announcement.

RPOP

Returns and removes one or more elements from the end of a list. Deletes the list if the last element was popped.

Usage
RPOP key [count]
Complexity
O(N) where N is the number of elements returned
Since
1.0.0
ACL Categories
@fast, @list, @write
Command flags
WRITE, FAST

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. Deletes the list if the last element was popped.

Examples

127.0.0.1:6379> RPUSH mylist "one" "two" "three" "four" "five"
(integer) 5
127.0.0.1:6379> RPOP mylist
"five"
127.0.0.1:6379> RPOP mylist 2
1) "four"
2) "three"
127.0.0.1:6379> LRANGE mylist 0 -1
1) "one"
2) "two"

Replies

RESP2

One of the following:

  • Nil reply: if the key does not exist.
  • Bulk string reply: when called without the count argument, the value of the last element.
  • Array reply: when called with the count argument, a list of popped elements.

RESP3

One of the following:

  • Null reply: if the key does not exist.
  • Bulk string reply: when called without the count argument, the value of the last element.
  • Array reply: when called with the count argument, a list of popped elements.

History

  • 6.2.0: Added the `count` argument.