SPOP key [count]
Removes and returns one or more random elements from the set value store at
This operation is similar to SRANDMEMBER, that returns one or more random elements from a set but does not remove it.
count argument is available since version 3.2.
Bulk string reply: the removed element, or
key does not exist.
(integer) 1redis> SADD myset "two"
(integer) 1redis> SADD myset "three"
(integer) 1redis> SPOP myset
"two"redis> SMEMBERS myset
1) "three" 2) "one"redis> SADD myset "four"
(integer) 1redis> SADD myset "five"
(integer) 1redis> SPOP myset 3
1) "three" 2) "four" 3) "five"redis> SMEMBERS myset
If count is bigger than the number of elements inside the Set, the command will only return the whole set without additional 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.
Redis 3.2 introduced an optional
count argument that can be passed to SPOP in order to retrieve multiple elements in a single call.
© 2009–2017 Salvatore Sanfilippo
Licensed under the Creative Commons Attribution-ShareAlike License 4.0.