summaryrefslogtreecommitdiffstats
path: root/iredis/data/commands/lrem.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/lrem.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/lrem.md')
-rw-r--r--iredis/data/commands/lrem.md28
1 files changed, 28 insertions, 0 deletions
diff --git a/iredis/data/commands/lrem.md b/iredis/data/commands/lrem.md
new file mode 100644
index 0000000..c06dda7
--- /dev/null
+++ b/iredis/data/commands/lrem.md
@@ -0,0 +1,28 @@
+Removes the first `count` occurrences of elements equal to `element` from the
+list stored at `key`. The `count` argument influences the operation in the
+following ways:
+
+- `count > 0`: Remove elements equal to `element` moving from head to tail.
+- `count < 0`: Remove elements equal to `element` moving from tail to head.
+- `count = 0`: Remove all elements equal to `element`.
+
+For example, `LREM list -2 "hello"` will remove the last two occurrences of
+`"hello"` in the list stored at `list`.
+
+Note that non-existing keys are treated like empty lists, so when `key` does not
+exist, the command will always return `0`.
+
+@return
+
+@integer-reply: the number of removed elements.
+
+@examples
+
+```cli
+RPUSH mylist "hello"
+RPUSH mylist "hello"
+RPUSH mylist "foo"
+RPUSH mylist "hello"
+LREM mylist -2 "hello"
+LRANGE mylist 0 -1
+```