Struct rxml::Parser

pub struct Parser { /* private fields */ }

Low-level XML Parser

The Parser converts crate::lexer::Tokens into Events.

It is a low-level interface which expects to be driven from a TokenRead source.

Implementations

impl Parser

pub fn new() -> Self

Create a new parser

pub fn with_context(ctx: RcPtr<Context>) -> Self

pub fn parse<'r, R: TokenRead>(&mut self, r: &'r mut R) -> Result<Option<Event>>

Parse a single event using tokens from r.

If the end of file has been reached after a well-formed document, None is returned. Otherwise, if the document is still will-formed, the next Event is returned.

If the document violates a well-formedness constraint, the XML 1.0 grammar or namespacing rules, the corresponding error is returned.

Errors from the token source (such as I/O errors) are forwarded.

Note: Exchanging the token source between calls to Parser::parse() is possible, but not advisible.

pub fn release_temporaries(&mut self)

Release all temporary buffers

This is sensible to call when it is expected that no more data will be processed by the parser for a while and the memory is better used elsewhere.

Trait Implementations

impl Debug for Parser

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

Formats the value using the given formatter.