跳至主要內容

複製鍵值 (LCC.kvdb.dict.copy_value)

聲明​

ok, old_value_or_err = LCC.kvdb.dict.copy_value(src_name, src_key, dst_name?, dst_key?, timeout?)

參數​

  • src_name
    字串型，來源詞典名稱（非空，最長 256 位元組）
  • src_key
    字串型，來源鍵名（必須為合法 UTF-8，且非空）
  • dst_name
    字串型，可選；目標詞典名稱，預設與來源相同（非空，最長 256 位元組）
  • dst_key
    字串型，可選；目標鍵名，預設與來源鍵名相同（必須為合法 UTF-8，且非空）
  • timeout
    數值型，可選；請求逾時時間（秒），預設 60

回傳值​

  • ok
    布林值，複製成功傳回 true，失敗傳回 false
  • old_value_or_err
    字串型或 nil；成功時為目標位置原值（不存在則為 nil），失敗時傳回錯誤描述

說明​

將值複製到目標鍵，來源鍵保持不變。
如果來源與目標完全一致，相當於讀取舊值並傳回 true, 舊值。
找不到來源鍵時傳回 false。

範例​

local ok, old = LCC.kvdb.dict.copy_value("範本", "預設設定", "使用者設定", "預設設定")
if not ok then
    error(old)
end