Struct SourceCursor 

pub struct SourceCursor<'s, S: Source + ?Sized> { /* private fields */ }

A cursor over a source that allows for efficient navigation and scanning.

Implementations

impl<'s, S: Source + ?Sized> SourceCursor<'s, S>

pub fn new(source: &'s S) -> Self

Creates a new SourceCursor at the start of the source.

pub fn new_at(source: &'s S, offset: usize) -> Self

Creates a new SourceCursor at the specified offset.

pub fn position(&self) -> usize

Returns the current byte offset of the cursor.

pub fn set_position(&mut self, offset: usize) -> usize

Sets the current byte offset of the cursor. Returns the previous offset.

pub fn source(&self) -> &'s S

Returns the source that this cursor is iterating over.

pub fn rest(&mut self) -> &str

Returns the remaining text in the current chunk.

pub fn chunk_end(&mut self) -> usize

Returns the end byte offset of the current chunk.

pub fn peek_char(&mut self) -> Option<char>

Peeks at the next character without advancing the cursor.

pub fn skip_ascii_whitespace(&mut self) -> Range<usize>

Skips common ASCII whitespace using SIMD if possible.

pub fn skip_ascii_digits(&mut self) -> Range<usize>

Skips ASCII digits using SIMD if possible.

pub fn skip_ascii_ident_continue(&mut self) -> Range<usize>

Skips ASCII identifier continue characters using SIMD if possible.

pub fn skip_until(&mut self, target: u8) -> Range<usize>

Skips until the specified byte is found.

pub fn peek_byte(&mut self) -> Option<u8>

Peeks at the next byte without advancing. the cursor.

pub fn advance_bytes(&mut self, len: usize) -> usize

Advances the cursor by the specified number of bytes.

pub fn advance_char(&mut self) -> Option<char>

Advances the cursor by one character and returns it.

pub fn advance_byte(&mut self) -> Option<u8>

Advances the cursor by one byte and returns it.

pub fn take_while(&mut self, pred: impl FnMut(char) -> bool) -> Range<usize>

Advances the cursor while the predicate is true and returns the range.

pub fn take_while_byte(&mut self, pred: impl FnMut(u8) -> bool) -> Range<usize>

Advances the cursor while the byte predicate is true and returns the range.

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

Returns true if the source text at the current position starts with the given pattern.

pub fn consume_if_starts_with(&mut self, pattern: &str) -> bool

Consumes the given pattern if it matches at the current position.

pub fn find_str(&mut self, pattern: &str) -> Option<usize>

Finds the first occurrence of the given pattern in the source text starting from the current position.

Trait Implementations

impl<'s, S: Source + ?Sized> Debug for SourceCursor<'s, S>

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

Formats the value using the given formatter.