emdb 0.9.9

Lightweight, high-performance embedded key-value database. Bitcask-style append-only journal, lock-free sharded hash index, at-rest encryption, sync + async APIs with streaming iterators.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

//! Zero-copy reads via `get_zerocopy`. Returns a `ValueRef<'_>` that
//! borrows directly from the mmap — no `Vec<u8>` allocation, no
//! decoding beyond frame validation. ~2× faster than `get` on small
//! values where the alloc dominates.
//!
//! Run with:
//! ```sh
//! cargo run --release --example zero_copy
//! ```

use emdb::Emdb;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let db = Emdb::open_in_memory();
    db.insert("config:max_conns", "1024")?;
    db.insert("config:host", "127.0.0.1")?;

    // get_zerocopy returns Option<ValueRef<'_>> — the slice lives
    // inside the mmap. No allocation here.
    if let Some(value) = db.get_zerocopy("config:max_conns")? {
        let bytes: &[u8] = value.as_ref();
        let s = std::str::from_utf8(bytes)?;
        println!("max_conns = {s}");
        assert_eq!(s, "1024");
    }

    // Same byte-level result as `get`, with no Vec allocation.
    let zc = db.get_zerocopy("config:host")?.expect("present");
    let owned = db.get("config:host")?.expect("present");
    assert_eq!(zc.as_ref(), owned.as_slice());

    // ValueRef converts to owned when the caller needs ownership.
    // `into_vec` consumes the ValueRef; the underlying mmap survives
    // as long as the Emdb handle does.
    let host_owned: Vec<u8> = zc.into_vec();
    drop(db);
    println!("host = {}", String::from_utf8_lossy(&host_owned));

    Ok(())
}