Struct TokenSpan 

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

Byte span carried by a Token.

Fields

start: usize

Starting byte position.

end: usize

Ending byte position.

Implementations

impl TokenSpan

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

Create a span from raw byte positions.

pub fn try_new(start: usize, end: usize) -> Result<Self, TokenSpanError>

Create a span, returning an error when end < start.

pub const fn len(self) -> usize

Span length in bytes.

pub const fn is_empty(self) -> bool

Whether the span length is zero bytes.

pub const fn range(self) -> Range<usize>

Convert this span to a standard Range.

pub const fn contains(self, offset: usize) -> bool

Return whether offset is inside this half-open span.

The start is inclusive and the end is exclusive, matching Rust Range semantics. Empty spans contain no offsets.

pub const fn touches(self, offset: usize) -> bool

Return whether offset touches this span, including the end boundary.

This is useful for cursor-oriented callers that need positions at token boundaries to resolve to the adjacent token. Empty spans touch exactly their single boundary offset.

pub const fn overlaps(self, other: Self) -> bool

Return whether this span overlaps other.

Spans are treated as half-open byte ranges, so adjacent spans such as 0..2 and 2..4 do not overlap. Empty spans never overlap.

pub const fn cover(self, other: Self) -> Self

Return the smallest span covering both spans.

Trait Implementations

impl Clone for TokenSpan

fn clone(&self) -> TokenSpan

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for TokenSpan

impl Debug for TokenSpan

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

Formats the value using the given formatter.

impl Eq for TokenSpan

impl PartialEq for TokenSpan

fn eq(&self, other: &TokenSpan) -> 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 StructuralPartialEq for TokenSpan