Struct Span 

pub struct Span {
    pub start: usize,
    pub end: usize,
}

A span in source code (byte offsets).

Spans use byte offsets for efficient slicing. Line/column information can be computed from the source text when needed for diagnostics.

Fields

start: usize

Byte offset of the start of the span (inclusive).

end: usize

Byte offset of the end of the span (exclusive).

Implementations

impl Span

pub const fn new(start: usize, end: usize) -> Self

Create a new span.

pub const fn single(pos: usize) -> Self

Create a span from a single byte offset.

pub const fn merge(self, other: Span) -> Span

Merge two spans into one that covers both.

pub const fn len(&self) -> usize

Get the length of the span in bytes.

pub const fn is_empty(&self) -> bool

Check if the span is empty.

pub fn slice<'a>(&self, source: &'a str) -> &'a str

Extract the text covered by this span from source.

pub fn to_positions(&self, source: &str) -> (Position, Position)

Convert byte offset span to line/column positions.

This scans the source text to compute line and column numbers. For performance, avoid calling this repeatedly; cache results if needed.

Trait Implementations

impl Clone for Span

fn clone(&self) -> Span

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Span

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for Span

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Hash for Span

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Span

fn eq(&self, other: &Span) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for Span

impl Eq for Span

impl StructuralPartialEq for Span