Zum Hauptinhalt springen

Wert schreiben und alten Wert zurückgeben (LCC.kvdb.dict.put)

Deklaration​

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

Parameter​

  • name
    String. Wörterbuchname (nicht leer, maximal 256 Byte).
  • key
    String. Schlüssel (muss gültiges UTF-8 und nicht leer sein).
  • value
    String. Neuer Wert (muss gültiges UTF-8 sein).
  • timeout
    Zahl, optional. Anfrage-Timeout in Sekunden, Standard 60.

Rückgabewerte​

  • old_value
    String oder nil. Vorheriger Wert, wenn der Schlüssel vorhanden war; bei neuen Schlüsseln nil.
  • err
    String oder nil. Bei Erfolg nil; bei fehlgeschlagener Anfrage enthält der Rückgabewert die Fehlermeldung.

Hinweise​

Schreibt einen Schlüssel und gibt atomar seinen vorherigen Wert zurück – nützlich für Vorgänge nach dem Muster „setzen und alten Wert abrufen“.
Wenn die Anfrage fehlschlägt, gibt die Funktion false, 错误信息 gefolgt von der Fehlermeldung zurück.

Beispiel​

local old, err = LCC.kvdb.dict.put("配置", "重试次数", "3")
if old == false then
    error(err)
end