본문으로 건너뛰기

큐 앞쪽에서 꺼내기 (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