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:
1if the element is moved. - valkey-protocol(7) Integer reply:
0if 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)