Trait tokenizer_lib::TokenReader

pub trait TokenReader<T: PartialEq, TData> {
    fn peek(&mut self) -> Option<&Token<T, TData>>;
    fn next(&mut self) -> Option<Token<T, TData>>;
    fn scan(
        &mut self, 
        cb: impl FnMut(&T, &TData) -> bool
    ) -> Option<&Token<T, TData>>;

    fn expect_next(
        &mut self, 
        expected_type: T
    ) -> Result<TData, Option<(T, Token<T, TData>)>> { ... }
}

A reader over a sequence of tokens

Required methods

fn peek(&mut self) -> Option<&Token<T, TData>>

Returns a reference to next token but does not advance current position

fn next(&mut self) -> Option<Token<T, TData>>

Returns the next token and advances

fn scan(
    &mut self,
    cb: impl FnMut(&T, &TData) -> bool
) -> Option<&Token<T, TData>>

Runs the closure (cb) over upcoming tokens. Passes the value behind the Token to the closure. Will stop and return a reference to the next Token from when the closure returns true. Returns None if scanning finishes before closure returns true. Does not advance the reader.

Used for lookahead and then branching based on return value during parsing

Provided methods

fn expect_next(
    &mut self,
    expected_type: T
) -> Result<TData, Option<(T, Token<T, TData>)>>

Tests that next token matches an expected type. Will return error if does not match. The Ok value contains the data of the valid token. Else it will return the Err with the expected token type and the token that did not match

Implementors

impl<T, TData, TGeneratorState, TGenerator> TokenReader<T, TData> for GeneratorTokenQueue<T, TData, TGeneratorState, TGenerator> where
    T: PartialEq + Debug,
    TData: Debug,
    for<'a> TGenerator: FnMut(&mut TGeneratorState, &mut GeneratorTokenQueueBuffer<'a, T, TData>), 

impl<T: PartialEq, TData> TokenReader<T, TData> for BufferedTokenQueue<T, TData>