跳到主要内容

队列头部弹出 (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