Skip to content
HotKVDocs

Ask the HotKV docs

Answers come only from these docs and can be wrong; check the linked pages before you rely on them.

SUNION

Last updated 
SUNION key [key ...]
Group
Set
Complexity
O(N) where N is the total number of members in all given sets
Arity
-2 (at least 2 words, counting the command name)
Flags
read-only
Keys
first 1, last final argument, step 1
HotKV Cloud
All plans
On-Premise
no license needed

SUNION returns the union of the given sets: every member that appears in at least one of them, once. Missing keys count as empty sets. To store the result, use SUNIONSTORE.

Return value

Section titled “Return value”
Case RESP2 RESP3
Success Array of bulk strings (empty if all keys are missing) Set of bulk strings

SUNION replies with a WRONGTYPE error if any of the keys holds a value that is not a set.

Examples

Section titled “Examples”
127.0.0.1:6379> SADD a "x" "y"
(integer) 2
127.0.0.1:6379> SADD b "y" "z"
(integer) 2
127.0.0.1:6379> SUNION a b
1) "x"
2) "y"
3) "z"

The order of members in the reply is not defined.

Compatibility

Section titled “Compatibility”

Same as Redis 7.4 and Valkey 8.

See also

Section titled “See also”

SUNIONSTORE, SINTER, SDIFF, ZUNION