ZREM key member [member …]

Available since 1.2.0.

Time complexity: O(M*log(N)) with N being the number of elements in the sorted set and M the number of elements to be removed.

Removes the specified members from the sorted set stored at key. Non existing members are ignored.

An error is returned when key exists and does not hold a sorted set.

*Return value

Integer reply, specifically:

  • The number of members removed from the sorted set, not including non existing members.

*History

  • >= 2.4: Accepts multiple elements. In Redis versions older than 2.4 it was possible to remove a single member per call.

*Examples

redis> ZADD myzset 1 "one"

  1. (integer) 1

redis> ZADD myzset 2 "two"

  1. (integer) 1

redis> ZADD myzset 3 "three"

  1. (integer) 1

redis> ZREM myzset "two"

  1. (integer) 1

redis> ZRANGE myzset 0 -1 WITHSCORES

  1. 1) "one"
  2. 2) "1"
  3. 3) "three"
  4. 4) "3"
redis>