Skip to main content

Clear Dictionary (LCC.kvdb.dict.clear)

Signature​

values, err = LCC.kvdb.dict.clear(name, timeout?)

Parameters​

  • name
    String. Dictionary name (non-empty, max 256 bytes).
  • timeout
    Number, optional. Request timeout in seconds, default 60.

Returns​

  • values
    Table. Snapshot of key/value pairs before clearing; returns an empty table when the dictionary was already empty, or nil on failure.
  • err
    String or nil. Error description when the call fails.

Notes​

Clears every key in the dictionary and returns a snapshot of the previous entries.
Useful when you need a backup of the previous contents before reset.

Example​

local values, err = LCC.kvdb.dict.clear("cache")
if values then
    local count = 0
    for _ in pairs(values) do count = count + 1 end
    LCC.log(1, "Cache cleared", count)
end