Struct EnvBuilder

pub struct EnvBuilder { /* private fields */ }

Constructs environment with settigs which couldn’t be changed after opening. By default it tries to create corresponding dir if it doesn’t exist, use autocreate_dir() to override that behavior

Implementations

impl EnvBuilder

pub fn new() -> EnvBuilder

Examples found in repository

examples/simple.rs (line 6)

fn main() {
    let env = EnvBuilder::new().open("test-lmdb", 0o777).unwrap();

    let db_handle = env.get_default_db(DbFlags::empty()).unwrap();
    let txn = env.new_transaction().unwrap();
    {
        let db = txn.bind(&db_handle); // get a database bound to this transaction

        let pairs = vec![("Albert", "Einstein",),
                         ("Joe", "Smith",),
                         ("Jack", "Daniels")];

        for &(name, surname) in pairs.iter() {
            db.set(&surname, &name).unwrap();
        }
    }

    // Note: `commit` is choosen to be explicit as
    // in case of failure it is responsibility of
    // the client to handle the error
    match txn.commit() {
        Err(_) => panic!("failed to commit!"),
        Ok(_) => ()
    }

    let reader = env.get_reader().unwrap();
    let db = reader.bind(&db_handle);
    let name = db.get::<&str>(&"Smith").unwrap();
    println!("It's {} Smith", name);
}

pub fn flags(self, flags: EnvCreateFlags) -> EnvBuilder

Sets environment flags

pub fn max_readers(self, max_readers: usize) -> EnvBuilder

Sets max concurrent readers operating on environment

pub fn max_dbs(self, max_dbs: usize) -> EnvBuilder

Set max number of databases

pub fn map_size(self, map_size: u64) -> EnvBuilder

Sets max environment size, i.e. size in memory/disk of all data

pub fn autocreate_dir(self, autocreate_dir: bool) -> EnvBuilder

Sets whetever lmdb-rs should try to autocreate dir with default permissions on opening (default is true)

pub fn open<P: AsRef<Path>>(self, path: P, perms: u32) -> MdbResult<Environment>

Opens environment in specified path

Examples found in repository

examples/simple.rs (line 6)

fn main() {
    let env = EnvBuilder::new().open("test-lmdb", 0o777).unwrap();

    let db_handle = env.get_default_db(DbFlags::empty()).unwrap();
    let txn = env.new_transaction().unwrap();
    {
        let db = txn.bind(&db_handle); // get a database bound to this transaction

        let pairs = vec![("Albert", "Einstein",),
                         ("Joe", "Smith",),
                         ("Jack", "Daniels")];

        for &(name, surname) in pairs.iter() {
            db.set(&surname, &name).unwrap();
        }
    }

    // Note: `commit` is choosen to be explicit as
    // in case of failure it is responsibility of
    // the client to handle the error
    match txn.commit() {
        Err(_) => panic!("failed to commit!"),
        Ok(_) => ()
    }

    let reader = env.get_reader().unwrap();
    let db = reader.bind(&db_handle);
    let name = db.get::<&str>(&"Smith").unwrap();
    println!("It's {} Smith", name);
}

Trait Implementations

impl Clone for EnvBuilder

fn clone(&self) -> EnvBuilder

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for EnvBuilder

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for EnvBuilder

fn default() -> Self

Returns the “default value” for a type.

impl Copy for EnvBuilder