跳到主要内容

# 批量删除行 (LCC.db.del)

## 声明​

    rows, err = LCC.db.del(name, id_rows, timeout?)

## 参数​

- name
  字符串型，表名称，必须非空且不超过 256 字节
- id_rows
  表类型，包含 `id` 的对象数组，或纯 `id` 数组；每个 `id` 都必须是大于等于 1 的整数值
- timeout
  数值型，可选；请求超时时间（秒），默认 `60`

## 返回值​

- rows
  表类型，被删除的行组成的数组；失败时为 `nil`
- err
  字符串型或 `nil`，失败时的错误描述（如 `'unknown table'`）

## 说明​

> 按 `id` 批量删除行，返回删除前的行数据，便于审计。
> 数组元素可以直接传 `id` 数字，也可以传包含 `id` 的对象；如果是对象，只会读取其中的 `id` 字段。
> 某项 `id` 不是大于等于 1 的整数值时，会触发 Lua 参数校验错误。

## 示例​

    local removed, err = LCC.db.del("任务表", { {id = 10}, 11, 12 })
    if removed then
        LCC.log(1, "已删除", #removed)
    end