Struct ByteSpan 

#[repr(C)]
pub struct ByteSpan {
    pub start: u32,
    pub end: u32,
}

A compact source span representing a half-open byte range [start, end).

This is the primary span type stored on all tokens, AST nodes, and parse errors. It is 8 bytes, Copy, and #[repr(C)] for predictable layout.

ByteSpan does not carry line/column/file information — those are resolved on demand via SourceMap::resolve_span().

Indexing Convention

Both start and end are 0-based byte offsets from the beginning of the source text. The range is half-open: start is the byte offset of the first character, and end is the byte offset immediately after the last character.

Fields

start: u32

Byte offset of the first character (inclusive).

end: u32

Byte offset immediately after the last character (exclusive).

Implementations

impl ByteSpan

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

Creates a new ByteSpan from start (inclusive) and end (exclusive) byte offsets.

pub fn len(&self) -> u32

Returns the length of this span in bytes.

pub fn is_empty(&self) -> bool

Returns true if the span is empty (zero length).

pub fn empty_at(offset: u32) -> Self

Creates an empty span at the given byte offset.

Useful for representing zero-width positions (e.g., EOF).

pub fn merge(self, other: ByteSpan) -> ByteSpan

Creates a span that covers both self and other.

The resulting span starts at the minimum start and ends at the maximum end of the two spans.

pub fn resolve(&self, source_map: &SourceMap<'_>) -> Option<SourceSpan>

Resolves this byte span to a SourceSpan with line/column positions using the given SourceMap.

Returns None if the byte offsets cannot be resolved. Convenience wrapper for SourceMap::resolve_span().

Trait Implementations

impl Clone for ByteSpan

fn clone(&self) -> ByteSpan

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ByteSpan

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

Formats the value using the given formatter.

impl Default for ByteSpan

fn default() -> ByteSpan

Returns the “default value” for a type.

impl Hash for ByteSpan

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 ByteSpan

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

impl Eq for ByteSpan

impl StructuralPartialEq for ByteSpan