Struct OwnedRset 

pub struct OwnedRset { /* private fields */ }

A freshly-built record set not yet inserted into a Db. Owns its rec_rset_t until handed to Db::append_rset, at which point ownership is transferred to the containing database.

Implementations

impl OwnedRset

pub fn new() -> Self

Examples found in repository

examples/write_rec.rs (line 12)

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mut db = Db::new();

    let mut rset = OwnedRset::new();

    let mut descriptor = Record::new();
    descriptor.append_field("%rec", "Book")?;
    descriptor.append_field("%type", "Year int")?;
    descriptor.append_field("%mandatory", "Title")?;
    rset.set_descriptor(descriptor);

    for (title, author, year) in [
        ("Refactoring", "Martin Fowler", "1999"),
        ("Domain-Driven Design", "Eric Evans", "2003"),
        ("Test-Driven Development", "Kent Beck", "2002"),
    ] {
        let mut record = Record::new();
        record.append_field("Title", title)?;
        record.append_field("Author", author)?;
        record.append_field("Year", year)?;
        rset.append_record(record)?;
    }

    db.append_rset(rset)?;
    println!("{}", db.to_rec_string()?);
    Ok(())
}

pub fn set_descriptor(&mut self, record: Record)

Install record as this rset’s descriptor (the %rec: / %type: / %mandatory: block). Ownership of the record transfers to the rset. Replaces and destroys any prior descriptor.

Examples found in repository

examples/write_rec.rs (line 18)

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mut db = Db::new();

    let mut rset = OwnedRset::new();

    let mut descriptor = Record::new();
    descriptor.append_field("%rec", "Book")?;
    descriptor.append_field("%type", "Year int")?;
    descriptor.append_field("%mandatory", "Title")?;
    rset.set_descriptor(descriptor);

    for (title, author, year) in [
        ("Refactoring", "Martin Fowler", "1999"),
        ("Domain-Driven Design", "Eric Evans", "2003"),
        ("Test-Driven Development", "Kent Beck", "2002"),
    ] {
        let mut record = Record::new();
        record.append_field("Title", title)?;
        record.append_field("Author", author)?;
        record.append_field("Year", year)?;
        rset.append_record(record)?;
    }

    db.append_rset(rset)?;
    println!("{}", db.to_rec_string()?);
    Ok(())
}

pub fn append_record(&mut self, record: Record) -> Result<(), Error>

Examples found in repository

examples/write_rec.rs (line 29)

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mut db = Db::new();

    let mut rset = OwnedRset::new();

    let mut descriptor = Record::new();
    descriptor.append_field("%rec", "Book")?;
    descriptor.append_field("%type", "Year int")?;
    descriptor.append_field("%mandatory", "Title")?;
    rset.set_descriptor(descriptor);

    for (title, author, year) in [
        ("Refactoring", "Martin Fowler", "1999"),
        ("Domain-Driven Design", "Eric Evans", "2003"),
        ("Test-Driven Development", "Kent Beck", "2002"),
    ] {
        let mut record = Record::new();
        record.append_field("Title", title)?;
        record.append_field("Author", author)?;
        record.append_field("Year", year)?;
        rset.append_record(record)?;
    }

    db.append_rset(rset)?;
    println!("{}", db.to_rec_string()?);
    Ok(())
}

Trait Implementations

impl Default for OwnedRset

fn default() -> Self

Returns the “default value” for a type.

impl Drop for OwnedRset

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.