W3cubDocs

/Redis

LPUSHX

LPUSHX key element [element ...]

Inserts specified values at the head of the list stored at key, only if key already exists and holds a list. In contrary to LPUSH, no operation will be performed when key does not yet exist.

Return value

Integer reply: the length of the list after the push operation.

History

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

Examples

redis> LPUSH mylist "World" (integer) 1 redis> LPUSHX mylist "Hello" (integer) 2 redis> LPUSHX myotherlist "Hello" (integer) 0 redis> LRANGE mylist 0 -1 1) "Hello" 2) "World" redis> LRANGE myotherlist 0 -1 (empty list or set)

© 2009–2020 Salvatore Sanfilippo
Licensed under the Creative Commons Attribution-ShareAlike License 4.0.
https://redis.io/commands/lpushx