Struct Cursor 

pub struct Cursor<'a>(/* private fields */);

Cursor of a string slice.

Implementations

impl<'a> Cursor<'a>

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

Creates a new string cursor from slice.

pub fn get_char(&mut self) -> char

Reads a single character.

Panics

Panics if there’s no valid character left in this slice.

pub fn advance<F, U>(&mut self, f: F) -> U

where F: FnOnce(&'a str) -> (U, &'a str),

Advances the inner cursor with given function.

pub fn try_advance<F, U, Err>(&mut self, f: F) -> Result<U, Err>

where F: FnOnce(&'a str) -> Result<(U, &'a str), Err>,

Advances the inner cursor if successed.

Errors

Returns an error if the given function returns one.

pub const fn get(&self) -> &'a str

Returns the underlying slice.

pub const fn set(&mut self, s: &'a str)

Overrides the underlying slice.

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

Advances the inner cursor by n bytes.

Panics

Panics if the inner slice doesn’t has n remaining bytes.

pub fn clear(&mut self)

Discards this cursor.

Trait Implementations

impl<'a> Clone for Cursor<'a>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for Cursor<'a>

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

Formats the value using the given formatter.