ZADD - Upstash Documentation

# Add three elements
assert redis.zadd("myset", {
    "one": 1,
    "two": 2,
    "three": 3
}) == 3

# No element is added since "one" and "two" already exist
assert redis.zadd("myset", {
    "one": 1,
    "two": 2
}, nx=True) == 0

# New element is not added since it does not exist
assert redis.zadd("myset", {
    "new-element": 1
}, xx=True) == 0

# Only "three" is updated since new score was greater
assert redis.zadd("myset", {
    "three": 10, "two": 0
}, gt=True) == 1

# Only "three" is updated since new score was greater
assert redis.zadd("myset", {
    "three": 10,
    "two": 0
}, gt=True) == 1

Arguments

str

required

The key of the sorted set.

Dict[str, float]

required

A dictionary of elements and their scores.

bool

Only update elements that already exist. Never add elements.

bool

Only add new elements. Never update elements.

bool

Update scores if the new score is greater than the old score.

bool

Update scores if the new score is less than the old score.

bool

Return the number of elements changed instead.

bool

When this option is specified ZADD acts like ZINCRBY. Only one score-element pair can be specified in this mode.

Response

The number of elements added to the sorted sets, not including elements already existing for which the score was updated.If ch was specified, the number of elements that were updated.If incr was specified, the new score of member.

# Add three elements
assert redis.zadd("myset", {
    "one": 1,
    "two": 2,
    "three": 3
}) == 3

# No element is added since "one" and "two" already exist
assert redis.zadd("myset", {
    "one": 1,
    "two": 2
}, nx=True) == 0

# New element is not added since it does not exist
assert redis.zadd("myset", {
    "new-element": 1
}, xx=True) == 0

# Only "three" is updated since new score was greater
assert redis.zadd("myset", {
    "three": 10, "two": 0
}, gt=True) == 1

# Only "three" is updated since new score was greater
assert redis.zadd("myset", {
    "three": 10,
    "two": 0
}, gt=True) == 1

SUNIONSTORE ZCARD

⌘I

​Arguments

​Response

Arguments

Response