spanner

Spanner — source code position and span tracking.

Types

Position

pub type Position {
  Position(line: Int, column: Int, byte_offset: Int)
}

Constructors

Position(line: Int, column: Int, byte_offset: Int)

Span

</>

pub type Span {
  Span(start: Position, end: Position)
}

Constructors

```
Span(start: Position, end: Position)
```

Values

advance

</>

pub fn advance(position: Position, source: String) -> Position

Advances a position in a source string. Handles \r\n and \r line endings. Columns count graphemes, so multi-byte characters like é advance the column by 1.

between

</>

pub fn between(start start: Position, end end: Position) -> Span

Creates a span between two positions.

label

</>

pub fn label(filename: String, span: Span) -> String

Formats a position with a filename, e.g. "src/main.gl:3:5".

start

</>

pub fn start() -> Position

Returns the initial position in a source file: line 1, column 1, byte offset 0.