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.


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


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>