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.

SDIFF

Last updated 
SDIFF 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

SDIFF returns the members of the set at the first key that are not in any of the sets at the following keys. Missing keys count as empty sets, so a missing first key gives an empty result. To store the result, use SDIFFSTORE.

Return value

Section titled “Return value”
Case RESP2 RESP3
Success Array of bulk strings (empty if nothing remains) Set of bulk strings

SDIFF 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" "z"
(integer) 3
127.0.0.1:6379> SADD b "y"
(integer) 1
127.0.0.1:6379> SADD c "z" "w"
(integer) 2
127.0.0.1:6379> SDIFF a b c
1) "x"

Compatibility

Section titled “Compatibility”

Same as Redis 7.4 and Valkey 8.

See also

Section titled “See also”

SDIFFSTORE, SINTER, SUNION, ZDIFF