summaryrefslogtreecommitdiffstats
path: root/iredis/data/commands/rpush.md
blob: 14a796bc19ec0e3d40fc1809bb6e26eabfaa3299 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
Insert all the specified values at the tail of the list stored at `key`. If
`key` does not exist, it is created as empty list before performing the push
operation. When `key` holds a value that is not a list, an error is returned.

It is possible to push multiple elements using a single command call just
specifying multiple arguments at the end of the command. Elements are inserted
one after the other to the tail of the list, from the leftmost element to the
rightmost element. So for instance the command `RPUSH mylist a b c` will result
into a list containing `a` as first element, `b` as second element and `c` as
third element.

@return

@integer-reply: the length of the list after the push operation.

@history

- `>= 2.4`: Accepts multiple `element` arguments. In Redis versions older than
  2.4 it was possible to push a single value per command.

@examples

```cli
RPUSH mylist "hello"
RPUSH mylist "world"
LRANGE mylist 0 -1
```