Struct FragmentReader 

pub struct FragmentReader { /* private fields */ }

Iterates the top-level subtrees of an XML file (the children of its root element), materializing one owned [Document] at a time.

Implementations

impl FragmentReader

pub fn open(path: &Path) -> Result<Self>

Open path for streaming. The file’s root element (e.g. the _lxfragment wrapper of a spilled segment, or ltx:document of a full core-XML file) is consumed as the container; fragments are its children.

pub fn next_fragment(&mut self) -> Result<Option<Document>>

Advance to the next top-level element and materialize its whole subtree as an owned, mutable [Document]. Returns Ok(None) at the end of the container. Non-element content between fragments (whitespace, comments, PIs) is skipped.

pub fn peek(&self) -> Option<RoNode>

Borrow the current subtree read-only without copying (valid only until the next advance) — for peeking at a fragment (name, attributes) before deciding to materialize it.