Перейти к основному содержимому

Копирование значения ключа (LCC.kvdb.dict.copy_value)

Сигнатура​

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

Параметры​

  • src_name
    Строка, имя исходного словаря (непустое, максимум 256 байт)
  • src_key
    Строка, имя исходного ключа (корректный UTF-8 и непустой)
  • dst_name
    Строка, необязательный; имя целевого словаря, по умолчанию совпадает с исходным (непустое, максимум 256 байт)
  • dst_key
    Строка, необязательный; имя целевого ключа, по умолчанию совпадает с исходным (корректный UTF-8 и непустой)
  • timeout
    Число, необязательный тайм-аут запроса (секунды), по умолчанию 60

Возвращаемое значение​

  • ok
    Логическое значение: при успешном копировании true, при сбое false
  • old_value_or_err
    Строка или nil; при успехе — прежнее значение в целевой позиции (при отсутствии — nil), при сбое — описание ошибки

Описание​

Копирует значение в целевой ключ, не изменяя исходный ключ.
Если источник и цель полностью совпадают, это эквивалентно чтению старого значения и возврату true, 旧值.
Если исходный ключ не найден, возвращается false.

Пример​

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