Skip to content
HotKVDocs

Ask the HotKV docs

Answers come only from these docs and can be wrong; check the linked pages before you rely on them.

RPUSHX

Last updated 
RPUSHX key element [element ...]
Group
List
Complexity
O(1) for each element added
Arity
-3 (at least 3 words, counting the command name)
Flags
write, fast
Keys
first 1, last 1, step 1
HotKV Cloud
All plans
On-Premise
no license needed

RPUSHX works like RPUSH, but only when key already holds a list. If the key does not exist, nothing is created and nothing is pushed.

Return value

Section titled “Return value”
Case RESP2 RESP3
List exists Integer: the length of the list after the push Same
Key does not exist Integer 0 Same

RPUSHX replies with a WRONGTYPE error if key holds a value that is not a list.

Examples

Section titled “Examples”
127.0.0.1:6379> RPUSHX queue a
(integer) 0
127.0.0.1:6379> RPUSH queue a
(integer) 1
127.0.0.1:6379> RPUSHX queue b c
(integer) 3
127.0.0.1:6379> LRANGE queue 0 -1
1) "a"
2) "b"
3) "c"

Compatibility

Section titled “Compatibility”

Same as Redis 7.4 and Valkey 8.

See also

Section titled “See also”

RPUSH, LPUSHX, LRANGE