Struct ParseContext 

pub struct ParseContext<'a> { /* private fields */ }

Parser context: a cursor over the token stream.

Implementations

impl<'a> ParseContext<'a>

pub fn new(tokens: &'a [Token], source: &'a str) -> Self

pub fn source(&self) -> &'a str

pub fn record_error(&mut self, message: &str)

Record a parse error at the current position.

pub fn record_error_at(&mut self, offset: u32, message: &str)

Record a parse error at a specific byte offset.

pub fn take_diagnostics(&mut self) -> Vec<ParseDiagnostic>

Take collected diagnostics, leaving the internal list empty.

pub fn pos(&self) -> usize

Current position in the token stream.

pub fn save(&self) -> usize

Save cursor position for backtracking.

pub fn restore(&mut self, pos: usize)

Restore cursor to a saved position.

pub fn peek(&self) -> Option<&'a Token>

Peek at the current token without consuming.

pub fn peek_kind(&self) -> Option<TokenKind>

Peek at the current non-trivia token kind.

pub fn peek_non_trivia(&self) -> Option<&'a Token>

Peek at the next non-trivia token (skipping whitespace/comments).

pub fn peek_keyword(&self, kw: &str) -> bool

Check if the next non-trivia token is a keyword matching kw (case-insensitive).

pub fn peek_keywords(&self, kws: &[&str]) -> bool

Check if next non-trivia tokens form a keyword sequence (e.g. “GROUP”, “BY”).

pub fn advance(&mut self) -> Option<&'a Token>

Consume and return the current token, advancing the cursor.

pub fn eat_trivia(&mut self) -> Vec<&'a Token>

Consume all leading trivia tokens and return them.

pub fn eat_keyword(&mut self, kw: &str) -> Option<&'a Token>

Try to consume a keyword (case-insensitive). Returns the token if matched.

pub fn eat_kind(&mut self, kind: TokenKind) -> Option<&'a Token>

Try to consume a specific token kind.

pub fn at_eof(&self) -> bool

Are we at EOF?

pub fn remaining(&self) -> &'a [Token]

Remaining tokens from current position.