Redis Iris

Redis install Data types

Tools Community Docs

Login Sign up

Develop with Redis Libraries and tools Redis products

Commands

Download documentation

Choose the products and versions you want. Everything arrives as one .tar.gz, with a directory per product.

Format

This page

	Products	Version
	Develop with Redis Clients, data types, programmability, and Redis for AI. RedisVL is listed separately.
	Libraries and tools Client libraries, observability, and cloud integrations. Redis Data Integration is listed separately.
	RedisVL
	Redis Software
	Redis Cloud
	Redis for Kubernetes
	Redis Open Source
	Redis Iris context engine
	Redis Feature Form
	Redis Insight
	Redis Data Integration
	Glossary
	Command reference

ZDIFFSTORE

Syntax text Syntax diagram API methods

ZDIFFSTORE destination numkeys key [key ...]

Client:

zdiffstore(
    dest: KeyT,
    keys: KeysT
) → ResponseT

Possible errors

ERR value is not an integer: ResponseError
ERR syntax error: ResponseError

See Redis error messages for what each error means. Other errors, such as connection errors, aren't listed.

zDiffStore(
    destination: RedisArgument,
    inputKeys: RedisVariadicArgument
) → NumberReply

Possible errors

ERR value is not an integer: SimpleError
ERR syntax error: SimpleError

See Redis error messages for what each error means. Other errors, such as connection errors, aren't listed.

zdiffstore(
    destination: RedisKey,
    numkeys: number | string,
    ...keys: RedisKey[],
    callback: Callback<number>
) → Result<number, Context>

zdiffstore(
    destination: RedisKey,
    numkeys: number | string,
    keys: RedisKey[],
    callback: Callback<number>
) → Result<number, Context>

zdiffstore(
    destination: RedisKey,
    numkeys: number | string,
    ...keys: RedisKey[]
) → Result<number, Context>

zdiffstore(
    destination: RedisKey,
    numkeys: number | string,
    keys: RedisKey[]
) → Result<number, Context>

Possible errors

ERR value is not an integer: ReplyError
ERR syntax error: ReplyError

See Redis error messages for what each error means. Other errors, such as connection errors, aren't listed.

zdiffStore(
    dstkey: byte[],
    keys: byte[]...
) → long  // 1 if the new element was added, 0 if the element was already a member of the sorted set and the score was updated

zdiffstore(
    dstkey: byte[],
    keys: byte[]...
) → long  // 1 if the new element was added, 0 if the element was already a member of the sorted set and the score was updated

zdiffStore(
    dstkey: String,
    keys: String...
) → long  // 1 if the new element was added, 0 if the element was already a member of the sorted set and the score was updated

zdiffstore(
    dstkey: String,
    keys: String...
) → long  // 1 if the new element was added, 0 if the element was already a member of the sorted set and the score was updated

Possible errors

ERR value is not an integer: JedisDataException
ERR syntax error: JedisDataException

See Redis error messages for what each error means. Other errors, such as connection errors, aren't listed.

zdiffstore(
    destKey: K,  // the dest key.
    srcKeys: K...  // the src keys.
) → Long  // Long the number of elements in the resulting sorted set at destination. @since 6.1

Possible errors

ERR value is not an integer: RedisCommandExecutionException
ERR syntax error: RedisCommandExecutionException

See Redis error messages for what each error means. Other errors, such as connection errors, aren't listed.

zdiffstore(
    destKey: K,  // the dest key.
    srcKeys: K...  // the src keys.
) → RedisFuture<Long>  // Long the number of elements in the resulting sorted set at destination. @since 6.1

Possible errors

ERR value is not an integer: RedisCommandExecutionException
ERR syntax error: RedisCommandExecutionException

See Redis error messages for what each error means. Other errors, such as connection errors, aren't listed.

zdiffstore(
    destKey: K,  // the dest key.
    srcKeys: K...  // the src keys.
) → Mono<Long>  // Long the number of elements in the resulting sorted set at destination. @since 6.1

Possible errors

ERR value is not an integer: RedisCommandExecutionException
ERR syntax error: RedisCommandExecutionException

See Redis error messages for what each error means. Other errors, such as connection errors, aren't listed.

ZDiffStore(
    ctx: context.Context,
    destination: string,
    keys: ...string
) → *IntCmd

Possible errors

ERR value is not an integer: redis.Error
ERR syntax error: redis.Error

See Redis error messages for what each error means. Other errors, such as connection errors, aren't listed.

SortedSetCombineAndStore(
    operation: SetOperation,  // The operation to perform.
    destination: RedisKey,  // The key to store the results in.
    first: RedisKey,
    second: RedisKey,
    aggregate: Aggregate,  // The aggregation method (defaults to sum).
    flags: CommandFlags  // The flags to use for this operation.
) → long  // The number of elements in the resulting sorted set at destination.

SortedSetCombineAndStore(
    operation: SetOperation,  // The operation to perform.
    destination: RedisKey,  // The key to store the results in.
    keys: RedisKey[],  // The keys of the sorted sets.
    weights: double[]?,  // The optional weights per set that correspond to keys.
    aggregate: Aggregate,  // The aggregation method (defaults to sum).
    flags: CommandFlags  // The flags to use for this operation.
) → long  // The number of elements in the resulting sorted set at destination.

SortedSetCombineAndStore(
    operation: SetOperation,  // The operation to perform.
    destination: RedisKey,  // The key to store the results in.
    first: RedisKey,
    second: RedisKey,
    aggregate: Aggregate,  // The aggregation method (defaults to sum).
    flags: CommandFlags  // The flags to use for this operation.
) → long  // The number of elements in the resulting sorted set at destination.

SortedSetCombineAndStore(
    operation: SetOperation,  // The operation to perform.
    destination: RedisKey,  // The key to store the results in.
    keys: RedisKey[],  // The keys of the sorted sets.
    weights: double[]?,  // The optional weights per set that correspond to keys.
    aggregate: Aggregate,  // The aggregation method (defaults to sum).
    flags: CommandFlags  // The flags to use for this operation.
) → long  // The number of elements in the resulting sorted set at destination.

Possible errors

ERR value is not an integer: RedisServerException
ERR syntax error: RedisServerException

See Redis error messages for what each error means. Other errors, such as connection errors, aren't listed.

SortedSetCombineAndStoreAsync(
    operation: SetOperation,  // The operation to perform.
    destination: RedisKey,  // The key to store the results in.
    first: RedisKey,
    second: RedisKey,
    aggregate: Aggregate,  // The aggregation method (defaults to sum).
    flags: CommandFlags  // The flags to use for this operation.
) → Task<long>  // The number of elements in the resulting sorted set at destination.

SortedSetCombineAndStoreAsync(
    operation: SetOperation,  // The operation to perform.
    destination: RedisKey,  // The key to store the results in.
    keys: RedisKey[],  // The keys of the sorted sets.
    weights: double[]?,  // The optional weights per set that correspond to keys.
    aggregate: Aggregate,  // The aggregation method (defaults to sum).
    flags: CommandFlags  // The flags to use for this operation.
) → Task<long>  // The number of elements in the resulting sorted set at destination.

SortedSetCombineAndStoreAsync(
    operation: SetOperation,  // The operation to perform.
    destination: RedisKey,  // The key to store the results in.
    first: RedisKey,
    second: RedisKey,
    aggregate: Aggregate,  // The aggregation method (defaults to sum).
    flags: CommandFlags  // The flags to use for this operation.
) → Task<long>  // The number of elements in the resulting sorted set at destination.

SortedSetCombineAndStoreAsync(
    operation: SetOperation,  // The operation to perform.
    destination: RedisKey,  // The key to store the results in.
    keys: RedisKey[],  // The keys of the sorted sets.
    weights: double[]?,  // The optional weights per set that correspond to keys.
    aggregate: Aggregate,  // The aggregation method (defaults to sum).
    flags: CommandFlags  // The flags to use for this operation.
) → Task<long>  // The number of elements in the resulting sorted set at destination.

Possible errors

ERR value is not an integer: RedisServerException
ERR syntax error: RedisServerException

See Redis error messages for what each error means. Other errors, such as connection errors, aren't listed.

zdiffstore(
    $destination: string,
    $keys: array
) → int

Possible errors

ERR value is not an integer: Predis\Response\ServerException
ERR syntax error: Predis\Response\ServerException

See Redis error messages for what each error means. Other errors, such as connection errors, aren't listed.

zdiffstore(
    destination: String,  // destination key
    keys: Array<String>  // source keys
) → Integer  // number of elements in the resulting sorted set

Possible errors

ERR value is not an integer: Redis::CommandError
ERR syntax error: Redis::CommandError

See Redis error messages for what each error means. Other errors, such as connection errors, aren't listed.

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:: @write, @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.

Computes the difference between the first and all successive input sorted sets and stores the result in destination. The total number of input keys is specified by numkeys.

Keys that do not exist are considered to be empty sets.

If destination already exists, it is overwritten.

Required arguments

destination

The key to store the resulting sorted set in.

numkeys

The number of keys that follow.

key [key ...]

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

Examples

redis> ZADD zset1 1 "one"
(integer) 1
redis> ZADD zset1 2 "two"
(integer) 1
redis> ZADD zset1 3 "three"
(integer) 1
redis> ZADD zset2 1 "one"
(integer) 1
redis> ZADD zset2 2 "two"
(integer) 1
redis> ZDIFFSTORE out 2 zset1 zset2
(integer) 1
redis> ZRANGE out 0 -1 WITHSCORES
1) "three"
2) "3"

Redis Software and Redis Cloud compatibility

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

Return information

RESP2 RESP3

Integer reply: the number of members in the resulting sorted set at destination.