Struct data::xml::Parser

pub struct Parser<'a> { /* private fields */ }

A simple event callback-based XML parser.

Implementations

impl<'a> Parser<'a>

pub fn new() -> Self

Create a parser with no callbacks.

pub fn addBeginHandler<F>(&mut self, tag: &'static str, handler: F)where F: FnMut(&[String], &BytesStart<'_>) -> Result<(), Error> + 'a,

Add a callback for an opening tag. If the parser encounters an opening tag whose name coincides with the value of tag, it calls handler with the opening tag event. Self-closing tags also trigger begin handlers.

pub fn addEndHandler<F>(&mut self, tag: &'static str, handler: F)where F: FnMut(&[String], &BytesEnd<'_>) -> Result<(), Error> + 'a,

Add a callback for an end tag. If the parser encounters an end tag whose name coincides with the value of tag (not including the starting /), it calls handler with the end tag event. Self-closing tags also trigger end handlers.

pub fn addTextHandler<F>(&mut self, tag: &'static str, handler: F)where F: FnMut(&[String], &str) -> Result<(), Error> + 'a,

Add a callback for text element directly inside some tag. If the parser encounters a text element where it’s enclosing tag coincides with the value of tag, it calls handler with the decoded text string.

Note that this does not mean the text needs to be the only or the last element in the enclosing tag.

pub fn addTagHandler<F>(&mut self, tag: &'static str, handler: F)where F: FnMut(&[String], &[u8]) -> Result<(), Error> + 'a,

Add a callback for a whole tag. If the parser encounters an opening element (including self-closing tags) whose name coincides with the value of tag, it calls handler with the content of the whole tag, including the opening and the closing tag. The parser then skips the whole tag.

This is useful if the user wants to delegate the parsing of a tag to another parser.

pub fn parse(&mut self, x: &[u8]) -> Result<(), Error>

Parse the XML in the byte buffer x, triggering the callbacks in the process. It is important to note that this buffer should only contains one root tag.