跳到主要内容

# 条件查询行列表 (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