Passer au contenu principal

Retirer depuis la tête de la file (LCC.kvdb.queue.pop_front)

Déclaration​

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

Paramètres​

  • name Type chaîne, nom de la file (non vide, 256 octets au maximum) ; pour le mode par lot, transmettez {name = "...", max = n}
  • timeout
    Type numérique, facultatif ; délai d'attente de la demande en secondes, 60 par défaut

Valeurs de retour​

  • value
    Type chaîne, élément retiré ; nil si la file est vide
  • values Tableau de chaînes, liste des éléments retirés en mode par lot ; {} si la file est vide
  • err Type chaîne ou nil ; en mode unitaire, renvoie 'not found' si la file est vide ou inexistante

Description​

Retire un élément depuis la tête de la file.
En mode par lot, renvoie au plus max éléments dans l'ordre réel de retrait. Une file vide renvoie nil, 'not found'.

Exemple​

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