Consultar una lista de filas por condiciones (LCC.db.list)

Declaración

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

Parámetros

• name
  Tipo string; nombre de la tabla, obligatorio, no vacío y de un máximo de 256 bytes
• opts
  Tipo table, opcional; tabla de parámetros de consulta:
  • conditions: condiciones de filtrado por igualdad en forma de pares clave-valor (combinadas con AND)
  • order_by: tipo string, campo de ordenación, predeterminado "id"
  • desc: tipo booleano, indica si se ordena de forma descendente, predeterminado false
  • limit: tipo entero, limita el número de filas devueltas
  • offset: tipo entero, desplazamiento, predeterminado 0
• timeout
  Tipo numérico, opcional; tiempo de espera de la solicitud (segundos), predeterminado 60

Valores devueltos

• rows
  Tipo table; array de filas que cumplen las condiciones; nil si falla
• err
  Tipo string o nil; descripción del error cuando falla (por ejemplo, unknown column o unknown table)

Descripción

Consulta una lista de filas según las condiciones; todos los valores de las columnas de usuario son cadenas.
Las columnas de usuario del objeto devuelto son cadenas y id es numérico.
Si no se proporciona opts, devuelve todos los datos ordenados de forma ascendente por id.

Ejemplo

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