Passer au contenu principal

Écrire et renvoyer l'ancienne valeur (LCC.kvdb.dict.put)

Déclaration​

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

Paramètres​

  • name
    Type chaîne, nom du dictionnaire (non vide, 256 octets au maximum)
  • key
    Type chaîne, nom de la clé (UTF-8 valide et non vide)
  • value
    Type chaîne, nouvelle valeur (UTF-8 valide)
  • timeout
    Type numérique, facultatif ; délai d'attente de la demande en secondes, 60 par défaut

Valeurs de retour​

  • old_value
    Type chaîne ou nil ; en cas de succès, ancienne valeur avant remplacement ; nil si la clé est nouvelle
  • err
    Type chaîne ou nil ; nil en cas de succès et description de l'erreur dans le cas contraire

Description​

Écrit la paire clé-valeur et renvoie l'ancienne valeur ; permet d'implémenter atomiquement « définir puis obtenir l'ancienne valeur ».
En cas d'échec de la demande, renvoie false, 错误信息.

Exemple​

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