Struct Document 

pub struct Document { /* private fields */ }

A whole file, losslessly.

Examples

use molframe_cif::{Document, parse};
use molframe_core::io::InputBuffer;

let input = InputBuffer::from_bytes(b"data_test\n_entry.id 1ABC\n".to_vec());
let (document, _) = parse(&input)?;

let id = document.first_block().and_then(|block| block.category("entry"))
    .and_then(|entry| entry.text("id", 0));
assert_eq!(id, Some("1ABC"));

Implementations

impl Document

pub const fn new() -> Self

Creates an empty document.

pub fn push(&mut self, block: DataBlock)

Appends a block.

pub fn first_block(&self) -> Option<&DataBlock>

The first block, which is the one a single-entry file has.

pub fn last_block_mut(&mut self) -> Option<&mut DataBlock>

The last block, which is the one still being filled while parsing.

pub fn blocks(&self) -> impl Iterator<Item = &DataBlock>

Every block, in order.

pub fn blocks_mut(&mut self) -> impl Iterator<Item = &mut DataBlock>

Every block, in order, for taking categories out of them.

pub fn len(&self) -> usize

The number of blocks.

pub fn is_empty(&self) -> bool

Returns true when the document holds no blocks.

Trait Implementations

impl Clone for Document

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Document

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

Formats the value using the given formatter.

impl Default for Document

fn default() -> Self

Returns the “default value” for a type.