Saltar al contenido principal

Copiar un valor de clave (LCC.kvdb.dict.copy_value)

Declaración​

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; nombre del diccionario de origen (no vacío, máximo 256 bytes)
  • src_key
    Tipo string; nombre de la clave de origen (debe ser UTF-8 válido y no vacío)
  • dst_name
    Tipo string, opcional; nombre del diccionario de destino, igual al de origen de forma predeterminada (no vacío, máximo 256 bytes)
  • dst_key
    Tipo string, opcional; nombre de la clave de destino, igual al de origen de forma predeterminada (debe ser UTF-8 válido y no vacío)
  • timeout
    Tipo numérico, opcional; tiempo de espera de la solicitud (segundos), predeterminado 60

Valores devueltos​

  • ok
    Tipo booleano; devuelve true si la copia tiene éxito y false si falla
  • old_value_or_err
    Tipo string o nil; si tiene éxito, es el valor anterior de la posición de destino (nil si no existía); si falla, contiene la descripción del error

Descripción​

Copia el valor en la clave de destino y mantiene intacta la clave de origen.
Si el origen y el destino son exactamente iguales, equivale a leer el valor anterior y devolver true, valor_anterior.
Devuelve false cuando no se encuentra la clave de origen.

Ejemplo​

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