跳到主要内容

条件查询行列表 (LCC.db.list)

声明​

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

参数​

  • name
    字符串型，表名称，必须非空且不超过 256 字节
  • opts
    表类型，可选；查询参数表：
    • conditions：键值对形式的等值过滤条件（AND 组合）
    • order_by：字符串型，排序字段，默认 "id"
    • desc：布尔型，是否降序，默认 false
    • limit：整数型，限制返回行数
    • offset：整数型，偏移量，默认 0
  • timeout
    数值型，可选；请求超时时间（秒），默认 60

返回值​

  • rows
    表类型，满足条件的行数组；失败时为 nil
  • err
    字符串型或 nil，失败时的错误描述（如 unknown column、unknown table）

说明​

按条件查询行列表，所有用户列值均为字符串。
返回对象中的用户列为字符串，id 为数值。
不传 opts 时默认返回按 id 升序的全部数据。

示例​

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