Struct Cursor 

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

A source-aware cursor over one Directive’s tokens during setup.

Implementations

impl<'a> Cursor<'a>

pub fn has_next(&self) -> bool

Whether another token remains after the current token.

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

Start before the first token.

pub fn next(&mut self) -> bool

Load the next token without regard to line boundaries.

pub fn next_arg(&mut self) -> bool

Load the next token only if it is on the current line.

pub fn next_line(&mut self) -> bool

Load the next token only if it starts a new source line.

pub fn next_block(&mut self) -> bool

Enter or continue a nested brace-delimited block.

pub fn val(&self) -> &str

Current token text, or an empty string before the first token.

pub fn file(&self) -> &str

Current source file, falling back to the initial filename.

pub fn line(&self) -> usize

Current source line, or zero before the first token.

pub fn args(&mut self, targets: &mut [&mut String]) -> bool

Fill targets with same-line arguments, leaving missing targets unchanged.

pub fn remaining_args(&mut self) -> Vec<String>

Consume the remaining same-line arguments, stopping before an opening brace.

pub fn error(&self, message: impl Into<String>) -> Error

Create an error at the current token.

pub fn arg_err(&self) -> Error

Create the standard missing or unexpected argument error.