SUNIONSTORE · Valkey

SUNIONSTORE

Stores the union of multiple sets in a key.

Usage

SUNIONSTORE destination key [key…]

Description

This command is equal to SUNION, but instead of returning the resulting set, it is stored in destination.

If destination already exists, it is overwritten.

Reply RESP2

Integer reply: the number of elements in the resulting set.

Reply RESP3

Integer reply: Number of the elements in the resulting set.

Complexity

O(N) where N is the total number of elements in all given sets.

ACL Categories

@set @slow @write

Examples

127.0.0.1:6379> SADD key1 "a"
(integer) 1
127.0.0.1:6379> SADD key1 "b"
(integer) 1
127.0.0.1:6379> SADD key1 "c"
(integer) 1
127.0.0.1:6379> SADD key2 "c"
(integer) 1
127.0.0.1:6379> SADD key2 "d"
(integer) 1
127.0.0.1:6379> SADD key2 "e"
(integer) 1
127.0.0.1:6379> SUNIONSTORE key key1 key2
(integer) 5
127.0.0.1:6379> SMEMBERS key
1) "a"
2) "b"
3) "c"
4) "d"
5) "e"

History

See also

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