Skip to main content

# Push To Queue Front (LCC.kvdb.queue.push_front)

## Signature​

    size, err = LCC.kvdb.queue.push_front(name, value, timeout?)

## Parameters​

- name
  String. Queue name (non-empty, max `256` bytes).
- value
  String, or a continuous string array. Strings must be valid UTF-8.
- timeout
  Number, optional. Request timeout in seconds, default `60`.

## Returns​

- size
  Number. Queue length after the push; `nil` on failure.
- err
  String or `nil`. Error message when the call fails.

## Notes​

> Pushes an item onto the head of the queue.
> Batch pushes preserve array order. For example, `{"a", "b"}` becomes the new head `a, b, ...`. Queue names cannot be empty.

## Example​

    local size, err = LCC.kvdb.queue.push_front("pending", "task#1")
    if size then
        LCC.log(1, "Queue size", size)
    end

    local batch_size, batch_err = LCC.kvdb.queue.push_front("pending", {"task#2", "task#3"})