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.

LPUSH

Last updated 
LPUSH 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

LPUSH inserts each element at the head (left end) of the list stored at key, creating the list if the key does not exist. Elements are inserted one after another from left to right, so LPUSH key a b c leaves c first.

Pushing to a list wakes clients blocked on it with BLPOP and related commands.

Return value

Section titled “Return value”
Case RESP2 RESP3
Success Integer: the length of the list after the push Same

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

Examples

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

Compatibility

Section titled “Compatibility”

Same as Redis 7.4 and Valkey 8.

See also

Section titled “See also”

RPUSH, LPUSHX, LPOP, LRANGE, BLPOP