summaryrefslogtreecommitdiffstats
path: root/iredis/data/commands/msetnx.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/msetnx.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/msetnx.md')
-rw-r--r--iredis/data/commands/msetnx.md24
1 files changed, 24 insertions, 0 deletions
diff --git a/iredis/data/commands/msetnx.md b/iredis/data/commands/msetnx.md
new file mode 100644
index 0000000..e332223
--- /dev/null
+++ b/iredis/data/commands/msetnx.md
@@ -0,0 +1,24 @@
+Sets the given keys to their respective values. `MSETNX` will not perform any
+operation at all even if just a single key already exists.
+
+Because of this semantic `MSETNX` can be used in order to set different keys
+representing different fields of an unique logic object in a way that ensures
+that either all the fields or none at all are set.
+
+`MSETNX` is atomic, so all given keys are set at once. It is not possible for
+clients to see that some of the keys were updated while others are unchanged.
+
+@return
+
+@integer-reply, specifically:
+
+- `1` if the all the keys were set.
+- `0` if no key was set (at least one key already existed).
+
+@examples
+
+```cli
+MSETNX key1 "Hello" key2 "there"
+MSETNX key2 "new" key3 "world"
+MGET key1 key2 key3
+```