書き込んで元の値を返す (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