smove.3valkey - Man Page
Moves a member from one set to another.
Synopsis
SMOVE
source destination member
Description
Move member
from the set at source
to the set at destination
. This operation is atomic. In every given moment the element will appear to be a member of source
or destination
for other clients.
If the source set does not exist or does not contain the specified element, no operation is performed and 0
is returned. Otherwise, the element is removed from the source set and added to the destination set. When the specified element already exists in the destination set, it is only removed from the source set.
An error is returned if source
or destination
does not hold a set value.
Reply
One of the following:
- valkey-protocol(7) Integer reply:
1
if the element is moved. - valkey-protocol(7) Integer reply:
0
if the element is not a member of source and no operation was performed.
Complexity
O(1)
Acl Categories
@fast @set @write
History
- Available since: 1.0.0
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 myotherset "three" (integer) 1 127.0.0.1:6379> SMOVE myset myotherset "two" (integer) 1 127.0.0.1:6379> SMEMBERS myset 1) "one" 127.0.0.1:6379> SMEMBERS myotherset 1) "three" 2) "two"
See Also
sadd(3valkey), scard(3valkey), sdiff(3valkey), sdiffstore(3valkey), sinter(3valkey), sintercard(3valkey), sinterstore(3valkey), sismember(3valkey), smembers(3valkey), smismember(3valkey), spop(3valkey), srandmember(3valkey), srem(3valkey), sscan(3valkey), sunion(3valkey), sunionstore(3valkey)