跳到主要内容

# 按值批量删除 (LCC.kvdb.queue.pop_values)

## 声明​

    count, err = LCC.kvdb.queue.pop_values(name, value, timeout?)

## 参数​

- name
  字符串型，队列名称（非空，最长 `256` 字节）
- value
  字符串型，要匹配删除的值（必须为合法 UTF-8）
- timeout
  数值型，可选；请求超时时间（秒），默认 `60`

## 返回值​

- count
  数值型，被删除的元素数量；失败时为 `nil`
- err
  字符串型或 `nil`，失败时的错误描述

## 说明​

> 原子地删除队列内所有匹配指定值的元素。
> 返回值表示本次删除的元素数量。

## 示例​

    local removed, err = LCC.kvdb.queue.pop_values("待处理", "timeout")
    if removed then
        LCC.log(2, "清理异常任务", removed)
    end