LPUSHX

Syntax

  1. LPUSHX key element [element ...]

Time complexity: O(1) for each element added, so O(N) to add N elements when the command is called with multiple arguments.

ACL categories: @write, @list, @fast

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

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

Examples

  1. dragonfly> LPUSH mylist "World"
  2. (integer) 1
  3. dragonfly> LPUSHX mylist "Hello"
  4. (integer) 2
  5. dragonfly> LPUSHX myotherlist "Hello"
  6. (integer) 0
  7. dragonfly> LRANGE mylist 0 -1
  8. 1) "Hello"
  9. 2) "World"
  10. dragonfly> LRANGE myotherlist 0 -1
  11. (empty array)