Zum Hauptinhalt springen

Zeilen mit Bedingungen abfragen (LCC.db.list)

Deklaration​

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

Parameter​

  • name
    String. Tabellenname. Darf nicht leer und höchstens 256 Byte lang sein.
  • opts
    Tabelle, optional. Abfrageoptionen:
    • conditions: Schlüsselwertpaare, mit AND kombiniert
    • order_by: String, Spalte für die Sortierung (standardmäßig "id")
    • desc: Boolean; gibt an, ob absteigend sortiert wird, Standard false
    • limit: Integer, maximale Anzahl zurückzugebender Zeilen
    • offset: Integer, Anzahl zu überspringender Zeilen (Standard 0)
  • timeout
    Zahl, optional. Anfrage-Timeout in Sekunden, Standard 60.

Rückgabewerte​

  • rows
    Tabelle. Array der passenden Zeilen; bei Fehler nil.
  • err
    String oder nil. Fehlerbeschreibung, etwa unknown column oder unknown table.

Hinweise​

Fragt Zeilen nach Bedingungen ab; alle Werte der Benutzer-Spalten sind Zeichenketten.
Benutzerspalten werden als Zeichenketten zurückgegeben, id dagegen als Zahl.
Ohne opts werden alle Datensätze in aufsteigender id-Reihenfolge zurückgegeben.

Beispiel​

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