Struct Stream

pub struct Stream<'a> {
    text: &'a str,
    pos: usize,
}

A streaming text parsing interface.

Fields

text: &'a str

pos: usize

Implementations

impl Stream<'_>

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

Parses angle from the stream.

https://www.w3.org/TR/SVG2/types.html#InterfaceSVGAngle

Notes

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

impl Stream<'_>

pub fn try_parse_color(&mut self) -> Option<Color>

Tries to parse a color, but doesn’t advance on error.

pub fn parse_color(&mut self) -> Result<Color, Error>

Parses a color.

impl Stream<'_>

pub fn parse_directional_position( &mut self, ) -> Result<DirectionalPosition, Error>

Parses a directional position [left, center, right, bottom, top] from the stream.

impl Stream<'_>

pub fn parse_font_families(&mut self) -> Result<Vec<FontFamily>, Error>

impl<'a> Stream<'a>

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

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

impl Stream<'_>

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

Parses length from the stream.

https://www.w3.org/TR/SVG2/types.html#InterfaceSVGLength

Notes

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

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

Parses length from a list of lengths.

impl Stream<'_>

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/SVG2/types.html#InterfaceSVGNumber

Errors

Returns only InvalidNumber.

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

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

Parses number from a list of numbers.

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 chars(&self) -> Chars<'a>

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 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.

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 consume_byte(&mut self, c: u8) -> Result<(), Error>

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

Errors

• InvalidChar
• UnexpectedEndOfStream

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

Parses a single ident.

Errors

• InvalidIdent

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

Consumes a single ident consisting of ASCII characters, if available.

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

Parses a single quoted string

Errors

• UnexpectedEndOfStream
• InvalidValue

pub fn consume_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 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_or_percent(&mut self) -> Result<f64, Error>

Parses number or percent from the stream.

Percent value will be normalized.

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

Parses number or percent from a list of numbers and/or percents.

pub fn skip_digits(&mut self)

Skips digits.

pub(crate) fn parse_list_separator(&mut self)

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> Eq for Stream<'a>

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