Copiar um par de chave-valor (LCC.kvdb.dict.copy_value)

Declaração

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

Parâmetros

• src_name
  Tipo string; nome do dicionário de origem (não vazio, no máximo 256 bytes)
• src_key
  Tipo string; nome da chave de origem (UTF-8 válido e não vazio)
• dst_name
  Tipo string, opcional; nome do dicionário de destino, por padrão igual ao de origem (não vazio, no máximo 256 bytes)
• dst_key
  Tipo string, opcional; nome da chave de destino, por padrão igual ao da chave de origem (UTF-8 válido e não vazio)
• timeout
  Tipo number, opcional; tempo limite da solicitação (em segundos), padrão 60

Valor de retorno

• ok
  Tipo boolean; retorna true quando a cópia tem sucesso e false quando falha
• old_value_or_err
  Tipo string ou nil; em caso de sucesso, valor original no destino (nil se não existir); em caso de falha, descrição do erro

Descrição

Copia o valor para a chave de destino e mantém a chave de origem inalterada.
Se a origem e o destino forem exatamente iguais, equivale a ler o valor antigo e retornar true, 旧值.
Retorna false quando a chave de origem não é encontrada.

Exemplo

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