Struct StrCursor

pub struct StrCursor<'a, Cmp = ExactCompare, Space = IgnoreSpace, Word = Wordish>
where
    Cmp: StrCompare,
    Space: SkipSpace,
    Word: SliceWord,
{ /* private fields */ }

Basic cursor implementation wrapping a string slice.

The Cmp parameter can be used to control the string comparison logic used.

Implementations

impl<'a, Cmp, Space, Word> StrCursor<'a, Cmp, Space, Word>

where Cmp: StrCompare, Space: SkipSpace, Word: SliceWord,

pub fn new(slice: &'a str) -> Self

Construct a new StrCursor with a specific offset.

The offset is logically the number of bytes which have already been consumed from the original input; these already-consumed bytes must not be included in slice.

Trait Implementations

impl<'a, Cmp, Space, Word> Clone for StrCursor<'a, Cmp, Space, Word>

where Cmp: StrCompare, Space: SkipSpace, Word: SliceWord,

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a, Cmp, Space, Word> Debug for StrCursor<'a, Cmp, Space, Word>

where Cmp: StrCompare + Debug, Space: SkipSpace + Debug, Word: SliceWord + Debug,

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

Formats the value using the given formatter.

impl<'a, Cmp, Space, Word> ScanCursor<'a> for StrCursor<'a, Cmp, Space, Word>

where Cmp: StrCompare, Space: SkipSpace, Word: SliceWord,

type ScanInput = StrCursor<'a, Cmp, Space, Word>

Corresponding scan input type.

fn try_end(self) -> Result<(), (ScanError, Self)>

Assert that the input has been exhausted, or that the current position is a valid place to “stop”.

fn try_scan<F, Out>(self, f: F) -> Result<(Out, Self), (ScanError, Self)>

where F: FnOnce(Self::ScanInput) -> Result<(Out, usize), ScanError>,

Scan a value from the current position. The closure will be called with all available input, and is expected to return either the scanned value, and the number of bytes of input consumed, or a reason why scanning failed.

fn try_scan_raw<F, Out>(self, f: F) -> Result<(Out, Self), (ScanError, Self)>

where F: FnOnce(Self::ScanInput) -> Result<(Out, usize), ScanError>,

Performs the same task as try_scan, except that it does not perform whitespace stripping.

fn try_match_literal(self, lit: &str) -> Result<Self, (ScanError, Self)>

Match the provided literal term against the input.

fn as_str(self) -> &'a str

Returns the remaining input as a string slice.

fn offset(&self) -> usize

Returns the number of bytes consumed by this cursor since its creation.

impl<'a, Cmp, Space, Word> ScanInput<'a> for StrCursor<'a, Cmp, Space, Word>

where Cmp: StrCompare, Space: SkipSpace, Word: SliceWord,

type ScanCursor = StrCursor<'a, Cmp, Space, Word>

Corresponding cursor type.

type StrCompare = Cmp

Marker type used to do string comparisons.

fn as_str(&self) -> &'a str

Get the contents of the input as a string slice.

fn from_subslice(&self, subslice: &'a str) -> Self

Create a new input from a subslice of this input’s contents.

fn to_cursor(&self) -> Self::ScanCursor

Turn the input into an independent cursor, suitable for feeding back into a user-facing scanning macro.

impl<'a, Cmp, Space, Word> Copy for StrCursor<'a, Cmp, Space, Word>

where Cmp: StrCompare, Space: SkipSpace, Word: SliceWord,