Struct Spans

pub struct Spans<'a> { /* private fields */ }

Zero-copy span utilities for AST node validation and manipulation

Provides safe methods to work with string slices that reference the original source text, maintaining zero-copy semantics.

Implementations

impl<'a> Spans<'a>

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

Create new span utilities for source text

pub fn validate_span(&self, span: &str) -> bool

Validate that a span references this source text

Returns true if the span is a valid substring of the source. Used for debug assertions to ensure zero-copy invariants.

pub fn span_offset(&self, span: &str) -> Option<usize>

Get byte offset of span within source

pub fn span_line(&self, span: &str) -> Option<usize>

Get line number (1-based) for a span

pub fn span_column(&self, span: &str) -> Option<usize>

Get column number (1-based) for a span

pub fn substring(&self, range: Range<usize>) -> Option<&'a str>

Extract substring by byte range

Trait Implementations

impl<'a> Clone for Spans<'a>

fn clone(&self) -> Spans<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for Spans<'a>

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

Formats the value using the given formatter.

impl<'a> PartialEq for Spans<'a>

fn eq(&self, other: &Spans<'a>) -> 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<'a> Copy for Spans<'a>

impl<'a> Eq for Spans<'a>

impl<'a> StructuralPartialEq for Spans<'a>