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

Ghi và trả về giá trị cũ (LCC.kvdb.dict.put)

Khai báo​

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

Tham số​

  • name
    Kiểu chuỗi, tên từ điển (không rỗng, tối đa 256 byte)
  • key
    Kiểu chuỗi, tên khóa (phải là UTF-8 hợp lệ và không rỗng)
  • value
    Kiểu chuỗi, giá trị mới (phải là UTF-8 hợp lệ)
  • 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ề​

  • old_value
    Kiểu chuỗi hoặc nil; khi thành công, trả về giá trị cũ trước khi thay thế; nếu là khóa mới, trả về nil
  • err
    Kiểu chuỗi hoặc nil; trả về nil khi thành công và nội dung mô tả lỗi khi có lỗi

Mô tả​

Ghi khóa-giá trị và trả về giá trị cũ, có thể dùng để thực hiện thao tác nguyên tử “đặt và lấy giá trị cũ”.
Khi yêu cầu thất bại, trả về false, thông tin lỗi.

Ví dụ​

local old, err = LCC.kvdb.dict.put("Cấu hình", "Số lần thử lại", "3")
if old == false then
error(err)
end