SREM · Valkey

SREM

Removes one or more members from a set. Deletes the set if the last member was removed.

Usage

SREM key member [member…]

Description

Remove the specified members from the set stored at key. Specified members that are not a member of this set are ignored. If key does not exist, it is treated as an empty set and this command returns 0.

An error is returned when the value stored at key is not a set.

Reply RESP2

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

Reply RESP3

Integer reply: Number of members that were removed from the set, not including non existing members.

Complexity

O(N) where N is the number of members to be removed.

ACL Categories

@fast @set @write

Examples

127.0.0.1:6379> SADD myset "one"
(integer) 1
127.0.0.1:6379> SADD myset "two"
(integer) 1
127.0.0.1:6379> SADD myset "three"
(integer) 1
127.0.0.1:6379> SREM myset "one"
(integer) 1
127.0.0.1:6379> SREM myset "four"
(integer) 0
127.0.0.1:6379> SMEMBERS myset
1) "two"
2) "three"

History

See also

SADD, SCARD, SDIFF, SDIFFSTORE, SINTER, SINTERCARD, SINTERSTORE, SISMEMBER, SMEMBERS, SMISMEMBER, SMOVE, SPOP, SRANDMEMBER, SSCAN, SUNION, SUNIONSTORE.