Struct 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.

Examples found in repository

examples/overview.rs (line 13)

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 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.

Examples found in repository

examples/overview.rs (line 26)

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 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()?);
}

Examples found in repository

examples/overview.rs (line 15)

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_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"));
    }
}

examples/overview.rs (line 21)

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 close(self)

👎Deprecated

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.