rpushx.3valkey - Man Page
Appends an element to a list only when the list exists.
Synopsis
RPUSHX
key element [element...]
Description
Inserts specified values at the tail of the list stored at key
, only if key
already exists and holds a list. In contrary to RPUSH
, no operation will be performed when key
does not yet exist.
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: 2.2.0
- Changed in 4.0.0: Accepts multiple
element
arguments.
Examples
127.0.0.1:6379> RPUSH mylist "Hello" (integer) 1 127.0.0.1:6379> RPUSHX mylist "World" (integer) 2 127.0.0.1:6379> RPUSHX myotherlist "World" (integer) 0 127.0.0.1:6379> LRANGE mylist 0 -1 1) "Hello" 2) "World" 127.0.0.1:6379> LRANGE myotherlist 0 -1 (empty array)
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), rpush(3valkey)