Struct DocxReader 

pub struct DocxReader { /* private fields */ }

A streaming DOCX reader that implements EventSource.

DocxReader parses a DOCX archive and emits DocSpec events one at a time. <w:p> paragraphs, <w:t> text, <w:br> line breaks, <w:tab> tabs, and table elements (<w:tbl>, <w:tr>, <w:tc>) are recognized; all other elements are silently ignored.

Streaming

The reader streams document.xml event by event using constant memory. _rels/.rels and word/_rels/document.xml.rels are both fully read into memory at package-open time (typical combined size < 10 KB). The internal event queue remains bounded regardless of document size or hyperlink count.

Errors

Returns Error::Io for I/O failures and Error::Parse for malformed archives or XML.

Implementations

impl DocxReader

pub fn from_path<P: AsRef<Path>>(path: P) -> Result<Self>

Creates a DocxReader from a file path.

Errors

Returns Error::Io if the file cannot be opened. See from_reader for additional error conditions.

pub fn from_reader<R: Read + Seek + Send + 'static>(reader: R) -> Result<Self>

Creates a DocxReader from any Read + Seek source.

The reader must be positioned at the start of a valid DOCX (ZIP) archive.

Errors

Returns Error::Parse if the input is not a valid ZIP archive, if _rels/.rels is missing or malformed, or if the document target entry cannot be opened. Returns Error::Io for I/O failures.

Trait Implementations

impl Debug for DocxReader

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

Formats the value using the given formatter.

impl EventSource for DocxReader

fn next_event(&mut self) -> Result<Option<Event>>

Returns the next event from the stream, or None if the stream has ended.