java.lang.Object
org.infinispan.server.resp.RespCommand
org.infinispan.server.resp.commands.sortedset.ZADD
All Implemented Interfaces:
Resp3Command

public class ZADD extends RespCommand implements Resp3Command
Adds all the specified members with the specified scores to the sorted set stored at key. It is possible to specify multiple score / member pairs. If a specified member is already a member of the sorted set, the score is updated and the element reinserted at the right position to ensure the correct ordering.

If key does not exist, a new sorted set with the specified members as sole members is created, like if the sorted set was empty. If the key exists but does not hold a sorted set, an error is returned.

Options:

  • XX: Only update elements that already exist. Don't add new elements.
  • NX: Only add new elements. Don't update already existing elements.
  • LT: Only update existing elements if the new score is less than the current score. This flag doesn't prevent adding new elements.
  • GT: Only update existing elements if the new score is greater than the current score. This flag doesn't prevent adding new elements.
  • CH: Modify the return value from the number of new elements added, to the total number of elements changed. Changed elements are new elements added and elements already existing for which the score was updated. Normally the return value of ZADD only counts the number of new elements added.
  • INCR: When this option is specified ZADD acts like ZINCRBY. Only one score-element pair can be specified in this mode.
Note: The GT, LT and NX options are mutually exclusive. The score values should be the string representation of a double precision floating point number. +inf and -inf values are valid values as well.
Since:
15.0
See Also: