Struct Record

pub struct Record<'a> { /* private fields */ }

Instance of a ESE database record in a currently open crate::Table.

Implementations

impl Record<'_>

pub fn value(&self, entry: i32) -> Result<Value>

Load a specific column/field value by entry number. Returned Value is bound to the lifetime of the database record.

Examples found in repository

examples/overview.rs (line 29)

fn main() {
    let filename = std::env::args()
        .nth(1)
        .expect("specify path to .esedb file");
    let db = EseDb::open(&filename).unwrap();
    println!("Database Overview ({}):", filename);
    for table in db.iter_tables().unwrap() {
        let table = table.unwrap();
        println!(
            "  {} [{:?}]",
            table.name().unwrap(),
            table
                .iter_columns()
                .unwrap()
                .map(|c| c.unwrap().name().unwrap())
                .collect::<Vec<String>>()
                .join(", "),
        );
        for record in table.iter_records().unwrap() {
            let record = record.unwrap();
            for i in 0..record.count_values().unwrap() {
                println!(
                    "  ├ T={:?} L={}, M={} V={:?}",
                    table.column(i).unwrap().variant().unwrap(),
                    record.is_long(i).unwrap(),
                    record.is_multi(i).unwrap(),
                    record.value(i).unwrap(),
                );
            }
        }
    }
}

pub fn is_long(&self, entry: i32) -> Result<bool>

Examples found in repository

examples/overview.rs (line 27)

fn main() {
    let filename = std::env::args()
        .nth(1)
        .expect("specify path to .esedb file");
    let db = EseDb::open(&filename).unwrap();
    println!("Database Overview ({}):", filename);
    for table in db.iter_tables().unwrap() {
        let table = table.unwrap();
        println!(
            "  {} [{:?}]",
            table.name().unwrap(),
            table
                .iter_columns()
                .unwrap()
                .map(|c| c.unwrap().name().unwrap())
                .collect::<Vec<String>>()
                .join(", "),
        );
        for record in table.iter_records().unwrap() {
            let record = record.unwrap();
            for i in 0..record.count_values().unwrap() {
                println!(
                    "  ├ T={:?} L={}, M={} V={:?}",
                    table.column(i).unwrap().variant().unwrap(),
                    record.is_long(i).unwrap(),
                    record.is_multi(i).unwrap(),
                    record.value(i).unwrap(),
                );
            }
        }
    }
}

pub fn is_multi(&self, entry: i32) -> Result<bool>

Examples found in repository

examples/overview.rs (line 28)

fn main() {
    let filename = std::env::args()
        .nth(1)
        .expect("specify path to .esedb file");
    let db = EseDb::open(&filename).unwrap();
    println!("Database Overview ({}):", filename);
    for table in db.iter_tables().unwrap() {
        let table = table.unwrap();
        println!(
            "  {} [{:?}]",
            table.name().unwrap(),
            table
                .iter_columns()
                .unwrap()
                .map(|c| c.unwrap().name().unwrap())
                .collect::<Vec<String>>()
                .join(", "),
        );
        for record in table.iter_records().unwrap() {
            let record = record.unwrap();
            for i in 0..record.count_values().unwrap() {
                println!(
                    "  ├ T={:?} L={}, M={} V={:?}",
                    table.column(i).unwrap().variant().unwrap(),
                    record.is_long(i).unwrap(),
                    record.is_multi(i).unwrap(),
                    record.value(i).unwrap(),
                );
            }
        }
    }
}

pub fn long<'a>(&self, entry: i32) -> Result<LongValue<'a>>

pub fn multi<'a>(&self, entry: i32) -> Result<MultiValue<'a>>

pub fn count_values(&self) -> Result<i32>

Returns number of values (columns/fields) in the record.

Examples found in repository

examples/overview.rs (line 23)

fn main() {
    let filename = std::env::args()
        .nth(1)
        .expect("specify path to .esedb file");
    let db = EseDb::open(&filename).unwrap();
    println!("Database Overview ({}):", filename);
    for table in db.iter_tables().unwrap() {
        let table = table.unwrap();
        println!(
            "  {} [{:?}]",
            table.name().unwrap(),
            table
                .iter_columns()
                .unwrap()
                .map(|c| c.unwrap().name().unwrap())
                .collect::<Vec<String>>()
                .join(", "),
        );
        for record in table.iter_records().unwrap() {
            let record = record.unwrap();
            for i in 0..record.count_values().unwrap() {
                println!(
                    "  ├ T={:?} L={}, M={} V={:?}",
                    table.column(i).unwrap().variant().unwrap(),
                    record.is_long(i).unwrap(),
                    record.is_multi(i).unwrap(),
                    record.value(i).unwrap(),
                );
            }
        }
    }
}

pub fn iter_values(&self) -> Result<impl Iterator<Item = Result<Value>> + '_>

Create an iterator over all the (column/field) values in the table record. The [IterEntries] iterator and the returned Values are bound to the lifetime of the database record.

for value in record.iter_values()? {
    println!("{:?}", value?);
}

Examples found in repository

examples/fh-catalog-strings.rs (line 13)

fn main() {
    let filename = std::env::args()
        .nth(1)
        .unwrap_or("Catalog1.edb".to_string());
    let db = EseDb::open(filename).unwrap();
    println!("Db load finished!");
    let string = db.table_by_name("string").unwrap();
    for rec in string.iter_records().unwrap() {
        let rec = rec.unwrap();
        let vals = rec
            .iter_values()
            .unwrap()
            .map(|v| v.unwrap_or_default().to_string())
            .collect::<Vec<_>>();
        println!("{}", vals.join("\t"));
    }
}

pub fn close(self)

👎Deprecated

When done reading, call this to free resources the record is using in memory.

Trait Implementations

impl Drop for Record<'_>

fn drop(&mut self)

Executes the destructor for this type.