Ir para o conteúdo principal

Gravar e retornar o valor original (LCC.kvdb.dict.put)

Declaração​

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

Parâmetros​

  • name
    Tipo string; nome do dicionário (não vazio, no máximo 256 bytes)
  • key
    Tipo string; nome da chave (UTF-8 válido e não vazio)
  • value
    Tipo string; novo valor (UTF-8 válido)
  • timeout
    Tipo number, opcional; tempo limite da solicitação (em segundos), padrão 60

Valor de retorno​

  • old_value
    Tipo string ou nil; em caso de sucesso, retorna o valor antigo antes da substituição; para uma chave nova, retorna nil
  • err
    Tipo string ou nil; retorna nil em caso de sucesso e a descrição do erro quando ocorre uma falha

Descrição​

Grava o par de chave-valor e retorna o valor antigo; pode ser usado para implementar uma operação atômica de "definir e obter o valor antigo".
Quando a solicitação falha, retorna false, 错误信息.

Exemplo​

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