跳到主要内容

写入并返回原值 (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