Struct Stream 

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

A streaming text parsing interface.

Implementations

impl<'a> Stream<'a>

pub fn pos(&self) -> usize

Returns the current position in bytes.

pub fn calc_char_pos(&self) -> usize

Calculates the current position in chars.

pub fn calc_char_pos_at(&self, byte_pos: usize) -> usize

Calculates the current position in chars.

pub fn jump_to_end(&mut self)

Sets current position equal to the end.

Used to indicate end of parsing on error.

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.

pub fn curr_byte(&self) -> Result<u8, Error>

Returns a byte from a current stream position.

Errors

• UnexpectedEndOfStream

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

pub fn is_curr_byte_eq(&self, c: u8) -> bool

Checks that current byte is equal to provided.

Returns false if no bytes left.

pub fn get_curr_byte(&self) -> Option<u8>

Returns a byte from a current stream position if there is one.

pub fn next_byte(&self) -> Result<u8, Error>

Returns a next byte from a current stream position.

Errors

• UnexpectedEndOfStream

pub fn advance(&mut self, n: usize)

Advances by n bytes.

Examples

pub fn skip_spaces(&mut self)

Skips whitespaces.

Accepted values: ' ' \n \r \t.

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.

pub fn starts_with_space(&self) -> bool

Checks if the stream is starts with a space.

Uses skip_spaces() internally.

pub fn consume_byte(&mut self, c: u8) -> Result<(), Error>

Consumes current byte if it’s equal to the provided byte.

Errors

• InvalidChar
• UnexpectedEndOfStream

Examples

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

Consumes selected string.

Errors

• InvalidChar
• UnexpectedEndOfStream

pub fn consume_bytes<F>(&mut self, f: F) -> &'a str

where F: Fn(&Stream<'_>, u8) -> bool,

Consumes bytes by the predicate and returns them.

The result can be empty.

pub fn skip_bytes<F>(&mut self, f: F)

where F: Fn(&Stream<'_>, u8) -> bool,

Consumes bytes by the predicate.

pub fn consume_ident(&mut self) -> &'a str

Consumes bytes by the predicate and returns them.

pub fn slice_back(&self, pos: usize) -> &'a str

Slices data from pos to the current position.

pub fn slice_tail(&self) -> &'a str

Slices data from the current position to the end.

pub fn parse_number(&mut self) -> Result<f64, Error>

Parses number from the stream.

This method will detect a number length and then will pass a substring to the f64::from_str method.

https://www.w3.org/TR/SVG11/types.html#DataTypeNumber

Errors

Returns only InvalidNumber.

pub fn parse_list_number(&mut self) -> Result<f64, Error>

Parses number from the list of numbers.

Examples

pub fn parse_integer(&mut self) -> Result<i32, Error>

Parses integer number from the stream.

Same as parse_number(), but only for integer. Does not refer to any SVG type.

pub fn parse_list_integer(&mut self) -> Result<i32, Error>

Parses integer from the list of numbers.

pub fn parse_length(&mut self) -> Result<Length, Error>

Parses length from the stream.

https://www.w3.org/TR/SVG11/types.html#DataTypeLength

Examples

Notes

• Suffix must be lowercase, otherwise it will be an error.

pub fn parse_list_length(&mut self) -> Result<Length, Error>

Parses length from the list of lengths.

pub fn parse_angle(&mut self) -> Result<Angle, Error>

Parses angle from the stream.

https://www.w3.org/TR/SVG11/types.html#DataTypeAngle

Notes

• Suffix must be lowercase, otherwise it will be an error.

pub fn skip_digits(&mut self)

Skips digits.

pub fn parse_iri(&mut self) -> Result<&'a str, Error>

Parses a IRI.

By the SVG spec, the ID must contain only Name characters, but since no one fallows this it will parse any characters.

pub fn parse_func_iri(&mut self) -> Result<&'a str, Error>

Parses a FuncIRI.

By the SVG spec, the ID must contain only Name characters, but since no one fallows this it will parse any characters.

Trait Implementations

impl<'a> Clone for Stream<'a>

fn clone(&self) -> Stream<'a>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<'a> Debug for Stream<'a>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'a> From<&'a str> for Stream<'a>

fn from(text: &'a str) -> Self

Converts to this type from the input type.

impl<'a> PartialEq for Stream<'a>

fn eq(&self, other: &Stream<'a>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'a> Copy for Stream<'a>

impl<'a> StructuralPartialEq for Stream<'a>