ZDIFF

Syntax text Syntax diagram API methods

ZDIFF numkeys key [key ...] [WITHSCORES]

Client:

zdiff(
    keys: KeysT,
    withscores: bool = False
) → ResponseT

ZDIFF(
    keys: RedisVariadicArgument
) → Any

zdiff(
    keys: String...
) → List<String>  // 1 if the new element was added, 0 if the element was already a member of the sorted set and the score was updated

zdiff(
    keys: K...  // the keys.
) → List<V>  // List&lt;V&gt; array-reply list of elements. @since 6.1

zdiff(
    keys: K...  // the keys.
) → RedisFuture<List<V>>  // List&lt;V&gt; array-reply list of elements. @since 6.1

zdiff(
    keys: K...  // the keys.
) → Flux<V>  // V array-reply list of elements. @since 6.1

ZDiff(
    ctx: context.Context,
    keys: ...string
) → *StringSliceCmd

zdiff(
    $keys: array,
    bool $withScores = false: Any
) → array

Available since:: Redis Open Source 6.2.0
Time complexity:: O(L + (N-K)log(N)) worst case where L is the total number of elements in all the sets, N is the size of the first set, and K is the size of the result set.
ACL categories:: @read, @sortedset, @slow,
Compatibility:: Redis Software and Redis Cloud compatibility

Note:

This command's behavior varies in clustered Redis environments. See the multi-key operations page for more information.

This command is similar to ZDIFFSTORE, but instead of storing the resulting sorted set, it is returned to the client.

Required arguments

numkeys

The number of keys that follow.

key [key ...]

One or more sorted-set keys. The result is the members of the first set that are not present in any of the subsequent sets.

Optional arguments

WITHSCORES

Also return the score of each member.

Examples

Redis Software and Redis Cloud compatibility

Redis Software	Redis Cloud	Notes
✅ Standard ✅ Active-Active	✅ Standard ✅ Active-Active

Return information

RESP2 RESP3

Array reply: the result of the difference including, optionally, scores when the WITHSCORES option is used.