cdb

This library provides pure Rust support for reading and writing CDB files. A CDB file is a constant key-value on-disk hash table, designed for high-speed lookups.

This is a fork of the cdb-rs crate.

Documentation

License

The Unlicense

lib.rs:

This crate provides support for reading and writing CDB files. A CDB is a "constant database" that acts as an on-disk associative array mapping keys to values, allowing multiple values for each key. It provides for fast lookups and low overheads. A constant database has no provision for updating, only rewriting from scratch.

Examples

Reading a set of records:

use cdb2::CDB;

let cdb = CDB::open("tests/test1.cdb")?;
for result in cdb.find(b"one") {
    println!("{:?}", result?);
}

Creating a database with safe atomic updating:

use cdb2::CDBWriter;

let mut cdb = CDBWriter::create("temporary.cdb")?;
cdb.add(b"one", b"Hello, ")?;
cdb.add(b"one", b"world!\n")?;
cdb.add(b"two", &[1, 2, 3, 4])?;
cdb.finish()?;

References

• D. J. Bernstein's original software
• Constant Database (cdb) Internals
• Wikipedia