Consultar uma lista de linhas por condições (LCC.db.list)

Declaração

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

Parâmetros

• name
  Tipo string; nome da tabela, não vazio e com no máximo 256 bytes
• opts
  Tipo table, opcional; tabela de parâmetros da consulta:
  • conditions: condições de filtragem por igualdade em pares de chave-valor (combinadas por AND)
  • order_by: tipo string; campo de ordenação, padrão "id"
  • desc: tipo boolean; define se a ordem é decrescente, padrão false
  • limit: tipo integer; limita o número de linhas retornadas
  • offset: tipo integer; deslocamento, padrão 0
• timeout
  Tipo number, opcional; tempo limite da solicitação (em segundos), padrão 60

Valor de retorno

• rows
  Tipo table; array de linhas que atendem às condições, ou nil em caso de falha
• err
  Tipo string ou nil; descrição do erro em caso de falha (como unknown column ou unknown table)

Descrição

Consulta uma lista de linhas por condições; todos os valores das colunas do usuário são strings.
As colunas do usuário no objeto retornado são strings, enquanto id é numérico.
Sem opts, retorna por padrão todos os dados em ordem crescente de id.

Exemplo

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