Zum Hauptinhalt springen

Schlüsselwert verschieben (LCC.kvdb.dict.move_value)

Deklaration​

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

Parameter​

  • src_name
    String. Name des Quellwörterbuchs (nicht leer, maximal 256 Byte).
  • src_key
    String. Quellschlüssel (gültiges, nicht leeres UTF-8).
  • dst_name
    String, optional. Name des Zielwörterbuchs, standardmäßig der Quellname (nicht leer, maximal 256 Byte).
  • dst_key
    String, optional. Zielschlüssel, standardmäßig der Quellschlüssel (gültiges, nicht leeres UTF-8).
  • timeout
    Zahl, optional. Anfrage-Timeout in Sekunden, Standard 60.

Rückgabewerte​

  • ok
    Boolean. Bei Erfolg true, bei Fehler false.
  • old_value_or_err
    String oder nil. Vorheriger Wert am Ziel (bei Nichtvorhandensein nil); bei Fehler enthält der Rückgabewert normalerweise eine Fehlerbeschreibung, für fehlende Quellschlüssel ist jedoch keine feste Meldung garantiert.

Hinweise​

Überträgt den Schlüssel atomar vom Quellwörterbuch zum Zielwörterbuch.
Wenn Quelle und Ziel identisch sind, löst die Funktion einen Fehler aus.
Bei erfolgreicher Verschiebung ohne vorherigen Zielwert wird true, nil zurückgegeben.
Fehlende Quellschlüssel geben false zurück; für den zweiten Rückgabewert ist keine feste Meldung garantiert.

Beispiel​

local ok, old = LCC.kvdb.dict.move_value("待处理", "task#1", "进行中", "task#1")
if not ok then
    error(old)
end