Removes the first count
occurrences of elements equal to value
from the list
stored at key
.
The count
argument influences the operation in the following ways:
count > 0
: Remove elements equal tovalue
moving from head to tail.count < 0
: Remove elements equal tovalue
moving from tail to head.count = 0
: Remove all elements equal tovalue
.
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
RPUSH mylist "hello"
RPUSH mylist "hello"
RPUSH mylist "foo"
RPUSH mylist "hello"
LREM mylist -2 "hello"
LRANGE mylist 0 -1