SPOP
Syntax
SPOP key [count]
- Available since:
- 1.0.0
- Time complexity:
- Without the count argument O(1), otherwise O(N) where N is the value of the passed count.
- ACL categories:
-
@write
,@set
,@fast
,
Removes and returns one or more random members from the set value store at key
.
This operation is similar to SRANDMEMBER
, that returns one or more random elements from a set but does not remove it.
By default, the command pops a single member from the set. When provided with
the optional count
argument, the reply will consist of up to count
members,
depending on the set's cardinality.
Examples
Distribution of returned elements
Note that this command is not suitable when you need a guaranteed uniform distribution of the returned elements. For more information about the algorithms used for SPOP
, look up both the Knuth sampling and Floyd sampling algorithms.
RESP2 Reply
One of the following:
- Nil reply: if the key does not exist.
- Bulk string reply: when called without the count argument, the removed member.
- Array reply: when called with the count argument, a aist of the removed members.
RESP3 Reply
One of the following:
- Null reply: if the key does not exist.
- Bulk string reply: when called without the count argument, the removed member.
- Array reply: when called with the count argument, a aist of the removed members.
History
- Starting with Redis version 3.2.0: Added the
count
argument.