What's new in Valkey 9.0? Discover new features and improvements. Read the announcement.

ZREM

Removes one or more members from a sorted set. Deletes the sorted set if all members were removed.

Usage
ZREM key member ...
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.
Since
1.2.0
ACL Categories
@fast, @sortedset, @write
Command flags
WRITE, FAST

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.

Examples

127.0.0.1:6379> ZADD myzset 1 "one"
(integer) 1
127.0.0.1:6379> ZADD myzset 2 "two"
(integer) 1
127.0.0.1:6379> ZADD myzset 3 "three"
(integer) 1
127.0.0.1:6379> ZREM myzset "two"
(integer) 1
127.0.0.1:6379> ZRANGE myzset 0 -1 WITHSCORES
1) "one"
2) "1"
3) "three"
4) "3"

Replies

RESP2

Integer reply: the number of members removed from the sorted set, not including non-existing members.

RESP3

Integer reply: the number of members removed from the sorted set, not including non-existing members.

History

  • 2.4.0: Accepts multiple elements.