ZREM key member [member ...]

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"
(integer) 1
redis>  ZADD myzset 2 "two"
(integer) 1
redis>  ZADD myzset 3 "three"
(integer) 1
redis>  ZREM myzset "two"
(integer) 1
redis>  ZRANGE myzset 0 -1 WITHSCORES
1) "one"
2) "1"
3) "three"
4) "3"
redis>