Struct XmlStreamReader

pub struct XmlStreamReader<T> { /* private fields */ }

XML stream reader specialized for working with OPC-UA XML.

Implementations

impl<T> XmlStreamReader<T>

where T: Read,

pub fn new(reader: T) -> XmlStreamReader<T>

Create a new stream reader with an internal buffer.

pub fn next_event(&mut self) -> Result<Event<'_>, XmlReadError>

Get the next event from the stream.

pub fn skip_value(&mut self) -> Result<(), XmlReadError>

Skip the current value. This should be called after encountering a Start event, and will skip until the corresponding End event is consumed.

Note that this does not check that the document is coherent, just that an equal number of start and end events are consumed.

pub fn consume_as_text(&mut self) -> Result<String, XmlReadError>

Consume the current event, skipping any child elements and returning the combined text content with leading and trailing whitespace removed. Note that if there are multiple text elements they will be concatenated, but whitespace between these will not be removed.

pub fn consume_raw(&mut self) -> Result<Vec<u8>, XmlReadError>

Consume the current element as a raw array of bytes.

pub fn consume_content<R>(&mut self) -> Result<R, XmlReadError>

where R: FromStr, XmlReadError: From<<R as FromStr>::Err>,

Consume the current node as a text value and parse it as the given type.

Trait Implementations

impl XmlReadExt for XmlStreamReader<&mut dyn Read>

fn iter_children_include_empty( &mut self, process: impl FnMut(String, Option<&mut Self>, &Context<'_>) -> EncodingResult<()>, context: &Context<'_>, ) -> EncodingResult<()>

Iterate over children, calling the provided callback for each tag. The callback must consume the tag, unless no reader is provided, in which case the tag is already closed.

fn iter_children( &mut self, process: impl FnMut(String, &mut Self, &Context<'_>) -> EncodingResult<()>, context: &Context<'_>, ) -> EncodingResult<()>

Iterate over children, calling the provided callback for each tag. The callback must consume the tag.

fn get_single_child<T>( &mut self, tag: &str, cb: impl FnOnce(&mut Self, &Context<'_>) -> Result<T, Error>, context: &Context<'_>, ) -> EncodingResult<Option<T>>

Call a callback for a single child element. This will consume the current node.

fn decode_single_child<T: XmlDecodable>( &mut self, tag: &str, context: &Context<'_>, ) -> EncodingResult<Option<T>>

Decode a single child element. This will consume the current node.

fn get_first_child<T>( &mut self, cb: impl FnOnce(String, &mut Self, &Context<'_>) -> Result<T, Error>, context: &Context<'_>, ) -> EncodingResult<Option<T>>

Call a callback for the first child element, then skip the rest. This will consume the current node.