跳至主要內容

刪除鍵值 (LCC.kvdb.dict.delete)

聲明​

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

參數​

  • name
    字串型，詞典名稱（非空，最長 256 位元組）
  • key
    字串型，鍵名（必須為合法 UTF-8，且非空）
  • timeout
    數值型，可選；請求逾時時間（秒），預設 60

回傳值​

  • value
    字串型，被刪除的舊值；不存在時為 nil
  • err
    字串型或 nil，不存在或失敗時傳回 'not found' 或錯誤描述

說明​

刪除指定鍵並傳回舊值。
可用於實現"讀取並刪除"的操作（配合 get 判斷）。

範例​

local old, err = LCC.kvdb.dict.delete("設定", "暫存鍵")
if old then
    LCC.log(2, "刪除舊設定", old)
end