Of_content_addressable.S
A content-addressable store is an indexed read-write store in which values are keyed directly by their hashes.
Read-only stores are store where it is only possible to read existing values.
type key = Key.t
The type for keys.
val mem : [> Import.read ] t -> key -> bool
mem t k
is true iff k
is present in t
.
val find : [> Import.read ] t -> key -> value option
find t k
is Some v
if k
is associated to v
in t
and None
is k
is not present in t
.
val add : [> Import.write ] t -> value -> key
Write the contents of a value to the store. It's the responsibility of the content-addressable store to generate a consistent key.
val unsafe_add : [> Import.write ] t -> key -> value -> unit
Same as add
but allows specifying the key directly. The backend might choose to discard that key and/or can be corrupt if the key scheme is not consistent.
val close : 'a t -> unit
close t
frees up all the resources associated with t
. Any operations run on a closed handle will raise Closed
.
val batch : Import.read t -> ([ Import.read | Import.write ] t -> 'a) -> 'a
batch t f
applies the writes in f
in a separate batch. The exact guarantees depend on the implementation.