佇列頭部彈出 (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