跳到主要内容

# 清空词典 (LCC.kvdb.dict.clear)

## 声明​

    values, err = LCC.kvdb.dict.clear(name, timeout?)

## 参数​

- name
  字符串型，词典名称（非空，最长 `256` 字节）
- timeout
  数值型，可选；请求超时时间（秒），默认 `60`

## 返回值​

- values
  表类型，被清空前的键值映射；词典原本为空时也返回空表，失败时为 `nil`
- err
  字符串型或 `nil`，失败时的错误描述

## 说明​

> 清空词典中的所有键值，并返回清空前的快照。
> 可以将返回值序列化作为备份。

## 示例​

    local values, err = LCC.kvdb.dict.clear("临时缓存")
    if values then
        local count = 0
        for _ in pairs(values) do count = count + 1 end
        LCC.log(1, "已清空缓存条目", count)
    end