Passer au contenu principal

Rechercher une liste de lignes par conditions (LCC.db.list)

Déclaration​

rows, err = LCC.db.list(name, opts?, timeout?)

Paramètres​

  • name
    Type chaîne, nom de la table, non vide et limité à 256 octets
  • opts
    Type table, facultatif ; table des paramètres de recherche :
    • conditions : conditions de filtrage par égalité sous forme de paires clé-valeur (combinaison AND)
    • order_by : type chaîne, champ de tri, "id" par défaut
    • desc : type booléen, indique si le tri est décroissant, false par défaut
    • limit : type entier, limite le nombre de lignes renvoyées
    • offset : type entier, décalage, 0 par défaut
  • timeout
    Type numérique, facultatif ; délai d'attente de la demande en secondes, 60 par défaut

Valeurs de retour​

  • rows
    Type table, tableau des lignes satisfaisant les conditions ; nil en cas d'échec
  • err
    Type chaîne ou nil, description de l'erreur en cas d'échec (par exemple unknown column ou unknown table)

Description​

Recherche les lignes selon les conditions ; toutes les valeurs des colonnes utilisateur sont des chaînes.
Dans l'objet renvoyé, les colonnes utilisateur sont des chaînes et id est numérique.
Sans opts, renvoie par défaut toutes les données triées par id croissant.

Exemple​

local rows, err = LCC.db.list("任务表", {
conditions = { 状态 = "空闲" },
order_by = "id",
limit = 20
})
if rows then
print("空闲任务数:", #rows)
end