Struct Cursor 

pub struct Cursor<'a> {
    pub source: &'a str,
    pub pos: usize,
    pub line: usize,
    pub column: usize,
    pub base_offset: usize,
}

源代码解析游标

Fields

source: &'a str

源代码字符串

pos: usize

当前字节偏移位置

line: usize

当前行号

column: usize

当前列号

base_offset: usize

基础偏移量

Implementations

impl<'a> Cursor<'a>

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

创建一个新的游标

pub fn with_position(source: &'a str, pos: Position) -> Self

从指定位置创建游标

pub fn with_sliced_source(source: &'a str, pos: Position) -> Self

从切片源创建游标

pub fn is_eof(&self) -> bool

判断是否已到达文件末尾

pub fn peek(&self) -> char

查看当前字符（不消费）

pub fn peek_n(&self, n: usize) -> char

查看第 n 个字符（不消费）

pub fn peek_str(&self, s: &str) -> bool

判断当前位置是否以指定字符串开头

pub fn consume(&mut self) -> char

消费当前字符

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

消费 n 个字符

pub fn consume_str(&mut self, s: &str) -> bool

如果匹配则消费字符串

pub fn consume_while<F>(&mut self, f: F) -> String

where F: Fn(char) -> bool,

消费满足条件的字符

pub fn skip_whitespace(&mut self)

跳过空白字符

pub fn consume_whitespace(&mut self) -> String

消费并返回空白字符

pub fn skip_spaces(&mut self)

跳过空格和制表符

pub fn expect(&mut self, expected: char) -> Result<()>

期望消费指定字符

pub fn expect_str(&mut self, expected: &str) -> Result<()>

期望消费指定字符串

pub fn position(&self) -> Position

获取当前位置

pub fn current_str(&self, start: usize) -> &str

获取从起始位置到当前位置的字符串

pub fn span_at_current(&self) -> Span

获取当前字符的位置范围

pub fn span_from(&self, start: Position) -> Span

获取从指定起始位置到当前位置的范围

pub fn consume_ident(&mut self) -> Result<String>

消费一个标识符

pub fn consume_string(&mut self) -> Result<String>

消费一个字符串字面量

pub fn span_at_pos(&self, pos: Position) -> Span

在指定位置创建一个零宽度的 Span