pub struct Stream<'a> { /* private fields */ }
Expand description
A streaming XML parsing interface.
Implementations§
source§impl<'a> Stream<'a>
impl<'a> Stream<'a>
sourcepub fn from_substr(text: &'a str, fragment: Range<usize>) -> Self
pub fn from_substr(text: &'a str, fragment: Range<usize>) -> Self
Creates a new stream from a specified text
substring.
sourcepub fn jump_to_end(&mut self)
pub fn jump_to_end(&mut self)
Sets current position equal to the end.
Used to indicate end of parsing on error.
sourcepub fn at_end(&self) -> bool
pub fn at_end(&self) -> bool
Checks if the stream is reached the end.
Any pos()
value larger than original text length indicates stream end.
Accessing stream after reaching end via safe methods will produce
an UnexpectedEndOfStream
error.
Accessing stream after reaching end via *_unchecked methods will produce a Rust’s bound checking error.
sourcepub fn curr_byte(&self) -> Result<u8, StreamError>
pub fn curr_byte(&self) -> Result<u8, StreamError>
sourcepub fn curr_byte_unchecked(&self) -> u8
pub fn curr_byte_unchecked(&self) -> u8
Returns a byte from a current stream position.
§Panics
- if the current position is after the end of the data
sourcepub fn next_byte(&self) -> Result<u8, StreamError>
pub fn next_byte(&self) -> Result<u8, StreamError>
sourcepub fn starts_with(&self, text: &[u8]) -> bool
pub fn starts_with(&self, text: &[u8]) -> bool
Checks that the stream starts with a selected text.
We are using &[u8]
instead of &str
for performance reasons.
§Examples
use xmlparser::Stream;
let mut s = Stream::from("Some text.");
s.advance(5);
assert_eq!(s.starts_with(b"text"), true);
assert_eq!(s.starts_with(b"long"), false);
sourcepub fn consume_byte(&mut self, c: u8) -> Result<(), StreamError>
pub fn consume_byte(&mut self, c: u8) -> Result<(), StreamError>
Consumes the current byte if it’s equal to the provided byte.
§Errors
InvalidChar
UnexpectedEndOfStream
§Examples
use xmlparser::Stream;
let mut s = Stream::from("Some text.");
assert!(s.consume_byte(b'S').is_ok());
assert!(s.consume_byte(b'o').is_ok());
assert!(s.consume_byte(b'm').is_ok());
assert!(s.consume_byte(b'q').is_err());
sourcepub fn try_consume_byte(&mut self, c: u8) -> bool
pub fn try_consume_byte(&mut self, c: u8) -> bool
Tries to consume the current byte if it’s equal to the provided byte.
Unlike consume_byte()
will not return any errors.
sourcepub fn skip_string(&mut self, text: &'static [u8]) -> Result<(), StreamError>
pub fn skip_string(&mut self, text: &'static [u8]) -> Result<(), StreamError>
sourcepub fn consume_bytes<F>(&mut self, f: F) -> StrSpan<'a>
pub fn consume_bytes<F>(&mut self, f: F) -> StrSpan<'a>
Consumes bytes by the predicate and returns them.
The result can be empty.
sourcepub fn skip_bytes<F>(&mut self, f: F)
pub fn skip_bytes<F>(&mut self, f: F)
Skips bytes by the predicate.
sourcepub fn consume_chars<F>(&mut self, f: F) -> Result<StrSpan<'a>, StreamError>
pub fn consume_chars<F>(&mut self, f: F) -> Result<StrSpan<'a>, StreamError>
Consumes chars by the predicate and returns them.
The result can be empty.
sourcepub fn skip_chars<F>(&mut self, f: F) -> Result<(), StreamError>
pub fn skip_chars<F>(&mut self, f: F) -> Result<(), StreamError>
Skips chars by the predicate.
sourcepub fn slice_back(&self, pos: usize) -> StrSpan<'a>
pub fn slice_back(&self, pos: usize) -> StrSpan<'a>
Slices data from pos
to the current position.
sourcepub fn slice_tail(&self) -> StrSpan<'a>
pub fn slice_tail(&self) -> StrSpan<'a>
Slices data from the current position to the end.
sourcepub fn skip_spaces(&mut self)
pub fn skip_spaces(&mut self)
Skips whitespaces.
Accepted values: ' ' \n \r \t
.
sourcepub fn starts_with_space(&self) -> bool
pub fn starts_with_space(&self) -> bool
Checks if the stream is starts with a space.
sourcepub fn consume_spaces(&mut self) -> Result<(), StreamError>
pub fn consume_spaces(&mut self) -> Result<(), StreamError>
Consumes whitespaces.
Like skip_spaces()
, but checks that first char is actually a space.
§Errors
InvalidSpace
sourcepub fn try_consume_reference(&mut self) -> Option<Reference<'a>>
pub fn try_consume_reference(&mut self) -> Option<Reference<'a>>
Consumes an XML character reference if there is one.
On error will reset the position to the original.
sourcepub fn consume_reference(&mut self) -> Result<Reference<'a>, StreamError>
pub fn consume_reference(&mut self) -> Result<Reference<'a>, StreamError>
Consumes an XML reference.
Consumes according to: https://www.w3.org/TR/xml/#NT-Reference
§Errors
InvalidReference
sourcepub fn consume_name(&mut self) -> Result<StrSpan<'a>, StreamError>
pub fn consume_name(&mut self) -> Result<StrSpan<'a>, StreamError>
Consumes an XML name and returns it.
Consumes according to: https://www.w3.org/TR/xml/#NT-Name
§Errors
InvalidName
- if name is empty or starts with an invalid charUnexpectedEndOfStream
sourcepub fn skip_name(&mut self) -> Result<(), StreamError>
pub fn skip_name(&mut self) -> Result<(), StreamError>
Skips an XML name.
The same as consume_name()
, but does not return a consumed name.
§Errors
InvalidName
- if name is empty or starts with an invalid char
sourcepub fn consume_qname(
&mut self,
) -> Result<(StrSpan<'a>, StrSpan<'a>), StreamError>
pub fn consume_qname( &mut self, ) -> Result<(StrSpan<'a>, StrSpan<'a>), StreamError>
Consumes a qualified XML name and returns it.
Consumes according to: https://www.w3.org/TR/xml-names/#ns-qualnames
§Errors
InvalidName
- if name is empty or starts with an invalid char
sourcepub fn consume_eq(&mut self) -> Result<(), StreamError>
pub fn consume_eq(&mut self) -> Result<(), StreamError>
Consumes =
.
Consumes according to: https://www.w3.org/TR/xml/#NT-Eq
§Errors
InvalidChar
UnexpectedEndOfStream
sourcepub fn consume_quote(&mut self) -> Result<u8, StreamError>
pub fn consume_quote(&mut self) -> Result<u8, StreamError>
sourcepub fn gen_text_pos(&self) -> TextPos
pub fn gen_text_pos(&self) -> TextPos
Calculates a current absolute position.
This operation is very expensive. Use only for errors.
sourcepub fn gen_text_pos_from(&self, pos: usize) -> TextPos
pub fn gen_text_pos_from(&self, pos: usize) -> TextPos
Calculates an absolute position at pos
.
This operation is very expensive. Use only for errors.
§Examples
let s = xmlparser::Stream::from("text");
assert_eq!(s.gen_text_pos_from(2), xmlparser::TextPos::new(1, 3));
assert_eq!(s.gen_text_pos_from(9999), xmlparser::TextPos::new(1, 5));
Trait Implementations§
source§impl<'a> PartialEq for Stream<'a>
impl<'a> PartialEq for Stream<'a>
impl<'a> Copy for Stream<'a>
impl<'a> Eq for Stream<'a>
impl<'a> StructuralPartialEq for Stream<'a>
Auto Trait Implementations§
impl<'a> Freeze for Stream<'a>
impl<'a> RefUnwindSafe for Stream<'a>
impl<'a> Send for Stream<'a>
impl<'a> Sync for Stream<'a>
impl<'a> Unpin for Stream<'a>
impl<'a> UnwindSafe for Stream<'a>
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
source§default unsafe fn clone_to_uninit(&self, dst: *mut T)
default unsafe fn clone_to_uninit(&self, dst: *mut T)
clone_to_uninit
)source§impl<T> CloneToUninit for Twhere
T: Copy,
impl<T> CloneToUninit for Twhere
T: Copy,
source§unsafe fn clone_to_uninit(&self, dst: *mut T)
unsafe fn clone_to_uninit(&self, dst: *mut T)
clone_to_uninit
)