rpush.3valkey - Man Page
Appends one or more elements to a list. Creates the key if it doesn’t exist.
Synopsis
RPUSH
key element [element...]
Description
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.
Reply
valkey-protocol(7) Integer reply: the length of the list after the push operation.
Complexity
O(1) for each element added, so O(N) to add N elements when the command is called with multiple arguments.
Acl Categories
@fast @list @write
History
- Available since: 1.0.0
- Changed in 2.4.0: Accepts multiple
element
arguments.
Examples
127.0.0.1:6379> RPUSH mylist "hello" (integer) 1 127.0.0.1:6379> RPUSH mylist "world" (integer) 2 127.0.0.1:6379> LRANGE mylist 0 -1 1) "hello" 2) "world"
See Also
blmove(3valkey), blmpop(3valkey), blpop(3valkey), brpop(3valkey), lindex(3valkey), linsert(3valkey), llen(3valkey), lmove(3valkey), lmpop(3valkey), lpop(3valkey), lpos(3valkey), lpush(3valkey), lpushx(3valkey), lrange(3valkey), lrem(3valkey), lset(3valkey), ltrim(3valkey), rpop(3valkey), rpushx(3valkey)