跳到主要内容

# 队列头部弹出 (LCC.kvdb.queue.pop_front)

## 声明​

    value, err = LCC.kvdb.queue.pop_front(name, timeout?)
    values, err = LCC.kvdb.queue.pop_front({name = name, max = n}, timeout?)

## 参数​

- name 字符串型，队列名称（非空，最长 `256` 字节）；传入 `{name = "...", max = n}` 时批量弹出
- timeout
  数值型，可选；请求超时时间（秒），默认 `60`

## 返回值​

- value
  字符串型，弹出的元素；队列为空时为 `nil`
- values 字符串数组，批量模式下弹出的元素列表；队列为空时为 `{}`
- err 字符串型或 `nil`；单值模式为空或不存在时返回 `'not found'`

## 说明​

> 从队列头部弹出一个元素。
> 批量模式按实际弹出顺序返回最多 `max` 个元素。 队列为空时返回 `nil, 'not found'`。

## 示例​

    local value, err = LCC.kvdb.queue.pop_front("待处理任务")
    if value then
        print("处理任务:", value)
    end

    local values, batch_err = LCC.kvdb.queue.pop_front({name = "待处理任务", max = 3})
    for _, item in ipairs(values or {}) do
        print("处理任务:", item)
    end