跳到主要内容

# 写入并返回原值 (LCC.kvdb.dict.put)

## 声明​

    old_value, err = LCC.kvdb.dict.put(name, key, value, timeout?)

## 参数​

- name
  字符串型，词典名称（非空，最长 `256` 字节）
- key
  字符串型，键名（必须为合法 UTF-8，且非空）
- value
  字符串型，新值（必须为合法 UTF-8）
- timeout
  数值型，可选；请求超时时间（秒），默认 `60`

## 返回值​

- old_value
  字符串型或 `nil`，成功时返回替换前的旧值；若为新键则返回 `nil`
- err
  字符串型或 `nil`，当为新键时固定为 `'not found'`；发生错误时返回错误描述

## 说明​

> 写入键值并返回旧值，可以用来实现"设置并获取旧值"的原子操作。
> 请求失败时返回 `false, 错误信息`。

## 示例​

    local old, err = LCC.kvdb.dict.put("配置", "重试次数", "3")
    if old == false then
        error(err)
    end