SPOP key [count]

Available since 1.0.0.

Time complexity: O(1)

Removes and returns one or more random elements 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.

The count argument is available since version 3.2.

*Return value

Bulk string reply: the removed element, or nil when key does not exist.

*Examples

redis> SADD myset "one"

  1. (integer) 1

redis> SADD myset "two"

  1. (integer) 1

redis> SADD myset "three"

  1. (integer) 1

redis> SPOP myset

  1. "one"

redis> SMEMBERS myset

  1. 1) "three"
  2. 2) "two"

redis> SADD myset "four"

  1. (integer) 1

redis> SADD myset "five"

  1. (integer) 1

redis> SPOP myset 3

  1. 1) "five"
  2. 2) "two"
  3. 3) "four"

redis> SMEMBERS myset

  1. 1) "three"
redis>

*Specification of the behavior when count is passed

If count is bigger than the number of elements inside the Set, the command will only return the whole set without additional elements.

*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.

*Count argument extension

Redis 3.2 introduced an optional count argument that can be passed to SPOP in order to retrieve multiple elements in a single call.