跳至主要內容

寫入並傳回原值 (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，成功時傳回 nil；發生錯誤時傳回錯誤描述

說明​

寫入鍵值並傳回舊值，可以用來實現"設定並取得舊值"的原子操作。
請求失敗時傳回 false, 錯誤資訊。

範例​

local old, err = LCC.kvdb.dict.put("設定", "重試次數", "3")
if old == false then
    error(err)
end