Trait XmlReader

pub trait XmlReader: Sized {
    // Required methods
    fn resolve<'n>(
        &self,
        name: QName<'n>,
        attribute: bool,
    ) -> (ResolveResult<'_>, LocalName<'n>);
    fn prefixes(&self) -> PrefixIter<'_>;
    fn current_position(&self) -> u64;
    fn error_position(&self) -> u64;

    // Provided methods
    fn extend_error(&self, error: Error) -> Error { ... }
    fn map_error<E>(&self, error: E) -> Error
       where Error: From<E> { ... }
    fn map_result<T, E>(&self, result: Result<T, E>) -> Result<T, Error>
       where Error: From<E> { ... }
    fn err<E>(&self, error: E) -> Result<(), Error>
       where Error: From<E> { ... }
    fn with_error_info(self) -> ErrorReader<Self> { ... }
}

Trait that defines the basics for an XML reader.

Required Methods

fn resolve<'n>( &self, name: QName<'n>, attribute: bool, ) -> (ResolveResult<'_>, LocalName<'n>)

Resolves a qname in the current context of the XML file.

fn prefixes(&self) -> PrefixIter<'_>

Returns an iterator the walks over all known namespace prefixes for the current context of the XML file.

fn current_position(&self) -> u64

Returns the current position (byte offset) in the current XML file.

fn error_position(&self) -> u64

Returns the position (byte offset) of the last detected error.

Provided Methods

fn extend_error(&self, error: Error) -> Error

Add the error position to the passed error and return it.

fn map_error<E>(&self, error: E) -> Error

where Error: From<E>,

Converts the passed error to an Error, adds the error information using extend_error and returns it.

fn map_result<T, E>(&self, result: Result<T, E>) -> Result<T, Error>

where Error: From<E>,

Same as map_error, but for the passed result.

fn err<E>(&self, error: E) -> Result<(), Error>

where Error: From<E>,

Create a result from the passed error using map_error and returns it.

fn with_error_info(self) -> ErrorReader<Self>

Wraps the current reader in a new ErrorReader.

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementors

impl XmlReader for SliceReader<'_>

impl<R> XmlReader for ErrorReader<R>

where R: XmlReader,

impl<R> XmlReader for IoReader<R>