Struct xml5ever::driver::XmlParser

pub struct XmlParser<Sink> where
    Sink: TreeSink,  {
    pub tokenizer: XmlTokenizer<XmlTreeBuilder<Sink::Handle, Sink>>,
}

An XML parser, ready to recieve Unicode input through the tendril::TendrilSink trait’s methods.

Fields

tokenizer: XmlTokenizer<XmlTreeBuilder<Sink::Handle, Sink>>

Tokenizer used by XmlParser.

Methods

impl<Sink: TreeSink> XmlParser<Sink>

fn from_utf8(self) -> Utf8LossyDecoder<Self>

Wrap this parser into a TendrilSink that accepts UTF-8 bytes.

Use this when your input is bytes that are known to be in the UTF-8 encoding. Decoding is lossy, like String::from_utf8_lossy.

fn from_bytes(self, opts: BytesOpts) -> BytesParser<Sink>

Wrap this parser into a TendrilSink that accepts bytes and tries to detect the correct character encoding.

Currently this looks for a Byte Order Mark, then uses BytesOpts::transport_layer_encoding, then falls back to UTF-8.

FIXME(https://github.com/servo/html5ever/issues/18): this should look for <meta> elements

Trait Implementations

impl<Sink: TreeSink> TendrilSink<UTF8> for XmlParser<Sink>

type Output = Sink::Output

What the overall result of processing is.

fn process(&mut self, t: StrTendril)

Process this tendril.

fn error(&mut self, desc: Cow<'static, str>)

Indicates that an error has occurred.

fn finish(self) -> Self::Output

Indicates the end of the stream.

fn one<T>(self, t: T) -> Self::Output where
    T: Into<Tendril<F, A>>, 

Process one tendril and finish.

fn from_iter<I>(self, i: I) -> Self::Output where
    I: IntoIterator,
    <I as IntoIterator>::Item: Into<Tendril<F, A>>, 

Consume an iterator of tendrils, processing each item, then finish.

fn read_from<R>(self, r: &mut R) -> Result<Self::Output, Error> where
    F: SliceFormat<Slice = [u8]>,
    R: Read, 

Read from the given stream of bytes until exhaustion and process incrementally, then finish. Return Err at the first I/O error.

fn from_file<P>(self, path: P) -> Result<Self::Output, Error> where
    F: SliceFormat<Slice = [u8]>,
    P: AsRef<Path>, 

Read from the file at the given path and process incrementally, then finish. Return Err at the first I/O error.