summaryrefslogtreecommitdiffstats
path: root/iredis/data/commands/zunionstore.md
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2020-03-21 10:28:17 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2021-02-07 11:16:53 +0000
commit06cba6ccd165ca8b224797e37fccb9e63f026d77 (patch)
treee82f1bc439997ae296f2e74f8a64d84c5d95f140 /iredis/data/commands/zunionstore.md
parentInitial commit. (diff)
downloadiredis-06cba6ccd165ca8b224797e37fccb9e63f026d77.tar.xz
iredis-06cba6ccd165ca8b224797e37fccb9e63f026d77.zip
Adding upstream version 1.9.1.upstream/1.9.1
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'iredis/data/commands/zunionstore.md')
-rw-r--r--iredis/data/commands/zunionstore.md38
1 files changed, 38 insertions, 0 deletions
diff --git a/iredis/data/commands/zunionstore.md b/iredis/data/commands/zunionstore.md
new file mode 100644
index 0000000..45b4b3b
--- /dev/null
+++ b/iredis/data/commands/zunionstore.md
@@ -0,0 +1,38 @@
+Computes the union of `numkeys` sorted sets given by the specified keys, and
+stores the result in `destination`. It is mandatory to provide the number of
+input keys (`numkeys`) before passing the input keys and the other (optional)
+arguments.
+
+By default, the resulting score of an element is the sum of its scores in the
+sorted sets where it exists.
+
+Using the `WEIGHTS` option, it is possible to specify a multiplication factor
+for each input sorted set. This means that the score of every element in every
+input sorted set is multiplied by this factor before being passed to the
+aggregation function. When `WEIGHTS` is not given, the multiplication factors
+default to `1`.
+
+With the `AGGREGATE` option, it is possible to specify how the results of the
+union are aggregated. This option defaults to `SUM`, where the score of an
+element is summed across the inputs where it exists. When this option is set to
+either `MIN` or `MAX`, the resulting set will contain the minimum or maximum
+score of an element across the inputs where it exists.
+
+If `destination` already exists, it is overwritten.
+
+@return
+
+@integer-reply: the number of elements in the resulting sorted set at
+`destination`.
+
+@examples
+
+```cli
+ZADD zset1 1 "one"
+ZADD zset1 2 "two"
+ZADD zset2 1 "one"
+ZADD zset2 2 "two"
+ZADD zset2 3 "three"
+ZUNIONSTORE out 2 zset1 zset2 WEIGHTS 2 3
+ZRANGE out 0 -1 WITHSCORES
+```