Chuyển tới nội dung chính

Sao chép giá trị khóa (LCC.kvdb.dict.copy_value)

Khai báo​

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

Tham số​

  • src_name
    Kiểu chuỗi, tên từ điển nguồn (không được rỗng, tối đa 256 byte)
  • src_key
    Kiểu chuỗi, tên khóa nguồn (phải là UTF-8 hợp lệ và không được rỗng)
  • dst_name
    Kiểu chuỗi, tùy chọn; tên từ điển đích, mặc định giống từ điển nguồn (không được rỗng, tối đa 256 byte)
  • dst_key
    Kiểu chuỗi, tùy chọn; tên khóa đích, mặc định giống tên khóa nguồn (phải là UTF-8 hợp lệ và không được rỗng)
  • timeout
    Kiểu số, tùy chọn; thời gian chờ yêu cầu (giây), mặc định là 60

Giá trị trả về​

  • ok
    Kiểu boolean, trả về true khi sao chép thành công và false khi thất bại
  • old_value_or_err
    Kiểu chuỗi hoặc nil; khi thành công là giá trị cũ tại vị trí đích (nếu không tồn tại thì là nil), khi thất bại trả về mô tả lỗi

Mô tả​

Sao chép giá trị sang khóa đích, khóa nguồn không thay đổi.
Nếu nguồn và đích hoàn toàn giống nhau, thao tác tương đương với việc đọc giá trị cũ và trả về true, giá trị cũ.
Trả về false khi không tìm thấy khóa nguồn.

Ví dụ​

local ok, old = LCC.kvdb.dict.copy_value("Mẫu", "Cấu hình mặc định", "Cấu hình người dùng", "Cấu hình mặc định")
if not ok then
error(old)
end