Struct libesedb::Table

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

Instance of a ESE database table in a currently open crate::EseDb.

Implementations

impl Table<'_>

pub fn name(&self) -> Result<String>

Gets the name of the table.

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

Total number of columns in table.

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

Total number of records (rows) in table.

pub fn column(&self, entry: i32) -> Result<Column<'_>>

Load a specific column by entry number. Returned Column is bound to the lifetime of the database table.

pub fn record(&self, entry: i32) -> Result<Record<'_>>

Load a specific record (row) by entry number. Returned Record is bound to the lifetime of the database table.

pub fn iter_columns(&self) -> Result<impl Iterator<Item = Result<Column<'_>>>>

Create an iterator over all the columns in the table. The [IterEntries] iterator and the returned Columns are bound to the lifetime of the database table.

for column in table.iter_columns()? {
    println!("{}", column?.name()?);
}

pub fn iter_records(&self) -> Result<impl Iterator<Item = Result<Record<'_>>>>

Create an iterator over all the records (rows) in the table. The [IterEntries] iterator and the returned Records are bound to the lifetime of the database table.

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

Examples found in repository

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

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)

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

Trait Implementations

impl Drop for Table<'_>

fn drop(&mut self)

Executes the destructor for this type.