Struct ParseableStr

Source

pub struct ParseableStr<'t, B: Backing> {
    pub position: usize,
    pub backing: &'t B,
    pub s: &'t str,
}

Fields§

§position: usize§backing: &'t B§s: &'t str

Implementations§

Source §

impl<'t, B: Backing> ParseableStr<'t, B>

Source

pub fn new(backing: &'t B) -> Self

Source

pub fn position_difference(&self, to: &Self) -> usize

Panics if to is before self.

Source

pub fn up_to(&self, to: &Self) -> Self

Panics if to is before self.

Source

pub fn eos(&self) -> ParseableStr<'t, B>

Return the end of this string, with the correct position.

Source

pub fn starts_with(&self, s: &str) -> bool

You usually want drop_str instead.

Source §

impl<'t, B: Backing> ParseableStr<'t, B>

Source

pub fn parse<T: FromStr>(&self) -> Result<T, Box<FromStrError>>
where T::Err: Display,

Parse the whole string via FromStr, returning error information.

Source

pub fn opt_parse<T: FromStr>(&self) -> Option<T>

Try to parse the whole string via FromStr.

Source

pub fn skip_bytes(&self, num_bytes: usize) -> ParseableStr<'t, B>

Skip the given number of bytes from the beginning. Panics if num_bytes goes beyond the end of self, and will lead to later panics if the result is not pointing at a character boundary.

Source

pub fn split_at(&self, mid: usize) -> (ParseableStr<'t, B>, ParseableStr<'t, B>)

Split at the given number of bytes from the beginning. Panics if mid > len, or not pointing at a character boundary.

Source

pub fn trim(&self) -> ParseableStr<'t, B>

Trim whitespace from start end end.

Source

pub fn trim_start(&self) -> ParseableStr<'t, B>

Trim whitespace from the end.

Source

pub fn trim_end(&self) -> ParseableStr<'t, B>

Trim whitespace from the end.

Source

pub fn find_str(&self, needle: &str) -> Option<ParseableStr<'t, B>>

Find the first occurrence of needle in self, return the needle and what follows.

Source

pub fn find_str_rest( &self, needle: &str, ) -> Option<(ParseableStr<'t, B>, ParseableStr<'t, B>)>

Find the first occurrence of needle in self, return the needle itself (with the position information of where it was found) and the rest after it.

Source

pub fn after_str(&self, needle: &str) -> Option<ParseableStr<'t, B>>

Find the first occurrence of needle in self, return the rest after it.

Source

pub fn drop_str(&self, beginning: &str) -> Option<ParseableStr<'t, B>>

Expect beginning at the start of self, if so return the remainder after it.

Source

pub fn expect_str( &self, beginning: &'t str, ) -> Result<ParseableStr<'t, B>, Box<ExpectedString<'t, B>>>

Same as drop_str but returns an error mentioning beginning if it doesn’t match

Source

pub fn expect_str_or_eos( &self, beginning: &'t str, ) -> Result<ParseableStr<'t, B>, Box<ExpectedString<'t, B>>>

Source

pub fn expect_separator( &self, separator: &Separator, ) -> Result<ParseableStr<'t, B>, Box<ExpectedString<'t, B>>>

Source

pub fn take_until_str(&self, needle: &str) -> Option<ParseableStr<'t, B>>

Find the first occurrence of needle in self, return the part left of it.

Source

pub fn split_at_str( &self, needle: &str, ) -> Option<(ParseableStr<'t, B>, ParseableStr<'t, B>)>

Split at the first occurrence of needle, returning the parts before and after it.

Source

pub fn take_while( &self, pred: impl FnMut(char) -> bool, ) -> (ParseableStr<'t, B>, ParseableStr<'t, B>)

Take every character for which pred returns true, return the string making up those characters and the remainder.

Source

pub fn expect1_matching( &self, pred: impl FnOnce(char) -> bool, desc: &'t str, ) -> Result<ParseableStr<'t, B>, Box<Expected<'t, B>>>

Expect 1 character for which pred must return true, return the string making up the remainder.

Source

pub fn take_identifier( &self, ) -> Result<(ParseableStr<'t, B>, ParseableStr<'t, B>), Box<Expected<'t, B>>>

Source

pub fn drop_while(&self, pred: impl FnMut(char) -> bool) -> ParseableStr<'t, B>

Source

pub fn take_n_while( &self, n: usize, pred: impl FnMut(char) -> bool, desc: &'t str, ) -> Result<(ParseableStr<'t, B>, ParseableStr<'t, B>), Box<Expected<'t, B>>>

Take n characters matching pred. Does not check whether there are more than n characters matching pred, just returns what was found so far.

Source

pub fn take_nrange_while( &self, n_min: usize, n_max: usize, pred: impl FnMut(char) -> bool, desc: &'t str, ) -> Result<(ParseableStr<'t, B>, ParseableStr<'t, B>), Box<Expected<'t, B>>>

Take n_min to n_max (inclusive) characters matching pred. Does not check whether there are more than n_max characters matching pred, just returns what was found so far.

Source

pub fn drop_whitespace(&self) -> ParseableStr<'t, B>

Source

pub fn split_str<'r, 'n>( &'r self, separator: &'n str, omit_empty_last_item: bool, ) -> Box<dyn Iterator<Item = ParseableStr<'t, B>> + 'n>
where 't: 'n, 'r: 'n,

Split on a fixed string, separator; the separator string is not included in the returned parts. If omit_empty_last_item is true, if there’s an empty string after the last separator, it is not reported as an item.