handle4 methods
A local key→bytes store opened by the datumhue.storage constructors. Handles comparing equal address the same store. A handle names the store rather than holding it open, so drop handles freely and open as many as needed.
The examples on this page start from:
local store = datumhue.storage.open("notes")Write value (a Bytes handle) under key. The write starts immediately; :ready() observes completion or failure.
-- Wrap the value in bytes; a plain string is not accepted.
store:set("best", datumhue.bytes.json({ score = 42 })):ready()
local best = store:get("best"):ready().value
print(best:json().score) --> 42In the guide: Remember things Save data between runs Waiting: suspending calls and handles
Storage:get(key: string) -> BytesFetchLook up key. The result's value is the stored bytes, or nil when the key is absent.
local theme = store:get("theme"):ready()
-- A key that was never set reads as nil.
print(theme.value) --> nil
store:set("theme", datumhue.bytes("dark")):ready()
print(store:get("theme"):ready().value:text()) --> darkIn the guide: Remember things Save data between runs Waiting: suspending calls and handles
Storage:delete(key: string) -> OpDelete the entry at key.
In the guide: Remember things Save data between runs
Storage:list(prefix?: string) -> ListFetchKeys in ascending order, optionally filtered by prefix.
store:set("level/2", datumhue.bytes("b")):ready()
store:set("level/1", datumhue.bytes("a")):ready()
store:set("name", datumhue.bytes("Ada")):ready()
-- Whole keys, in ascending order.
local levels = store:list("level/"):ready().value
print(table.concat(levels, ", ")) --> level/1, level/2In the guide: Save data between runs