Passer au contenu principal

Copier une valeur clé-valeur (LCC.kvdb.dict.copy_value)

Déclaration​

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

Paramètres​

  • src_name
    Type chaîne, nom du dictionnaire source (non vide, 256 octets au maximum)
  • src_key
    Type chaîne, nom de la clé source (UTF-8 valide et non vide)
  • dst_name
    Type chaîne, facultatif ; nom du dictionnaire cible, identique à la source par défaut (non vide, 256 octets au maximum)
  • dst_key
    Type chaîne, facultatif ; nom de la clé cible, identique à la clé source par défaut (UTF-8 valide et non vide)
  • timeout
    Type numérique, facultatif ; délai d'attente de la demande en secondes, 60 par défaut

Valeurs de retour​

  • ok
    Type booléen ; renvoie true si la copie réussit et false dans le cas contraire
  • old_value_or_err
    Type chaîne ou nil ; en cas de succès, ancienne valeur à l'emplacement cible (nil s'il n'existait pas), et description de l'erreur en cas d'échec

Description​

Copie la valeur vers la clé cible sans modifier la clé source.
Si la source et la cible sont parfaitement identiques, l'opération équivaut à lire l'ancienne valeur et à renvoyer true, 旧值.
Renvoie false si la clé source est introuvable.

Exemple​

local ok, old = LCC.kvdb.dict.copy_value("模板", "默认配置", "用户配置", "默认配置")
if not ok then
    error(old)
end