Struct Span 

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

A span in the source code, represented as a byte range.

#[non_exhaustive] policy

Deliberately NOT #[non_exhaustive], unlike rustledger_parser::{ParseResult, ParseError, ParseErrorKind}. Span is constructed via struct literal in hundreds of call sites across the workspace (every parser rule, every test fixture, every LSP/FFI/loader path that synthesizes a location). Marking it non-exhaustive would force a workspace-wide migration to Span::new for zero practical benefit — the struct has carried the same two fields since the project’s inception and there is no realistic future field that would justify breaking that surface. If a future need arises (e.g., line: Option<u32> for faster LSP position lookups), the right move is to add a sibling type with non_exhaustive rather than retrofit it onto Span.

Fields

start: usize

Start byte offset (inclusive).

end: usize

End byte offset (exclusive).

Implementations

impl Span

pub const ZERO: Self

The zero span (0..0). Used as the location for programmatically synthesized values that have no source representation. Pair with SYNTHESIZED_FILE_ID on the containing Spanned to make the “no source” intent unambiguous.

use rustledger_core::Span;
assert_eq!(Span::ZERO, Span::new(0, 0));
assert!(Span::ZERO.is_empty());

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

Create a new span.

pub const fn from_range(range: Range<usize>) -> Self

Create a span from a range.

pub const fn len(&self) -> usize

Get the length of this span in bytes.

pub const fn is_empty(&self) -> bool

Check if the span is empty.

pub fn merge(&self, other: &Self) -> Self

Merge this span with another, returning a span that covers both.

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

Get the source text for this span.

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

Convert to a byte-offset Range<usize> for downstream span consumers.

Trait Implementations

impl Archive for Span

where usize: Archive,

const COPY_OPTIMIZATION: CopyOptimization<Self>

An optimization flag that allows the bytes of this type to be copied directly to a writer instead of calling serialize.

type Archived = ArchivedSpan

The archived representation of this type.

type Resolver = SpanResolver

The resolver for this type. It must contain all the additional information from serializing needed to make the archived type from the normal type.

fn resolve(&self, resolver: Self::Resolver, out: Place<Self::Archived>)

Creates the archived version of this value at the given position and writes it to the given output.

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 Copy for Span

impl Debug for Span

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Span

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<__D: Fallible + ?Sized> Deserialize<Span, __D> for Archived<Span>

where usize: Archive, <usize as Archive>::Archived: Deserialize<usize, __D>,

fn deserialize( &self, deserializer: &mut __D, ) -> Result<Span, <__D as Fallible>::Error>

Deserializes using the given deserializer

impl Display for Span

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

Formats the value using the given formatter.

impl Eq for Span

impl From<Range<usize>> for Span

fn from(range: Range<usize>) -> Self

Converts to this type from the input type.

impl From<Span> for Range<usize>

fn from(span: Span) -> Self

Converts to this type from the input type.

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 Serialize for Span

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl<__S: Fallible + ?Sized> Serialize<__S> for Span

where usize: Serialize<__S>,

fn serialize( &self, serializer: &mut __S, ) -> Result<<Self as Archive>::Resolver, <__S as Fallible>::Error>

Writes the dependencies for the object and returns a resolver that can create the archived type.

impl ShiftSpans for Span

fn shift_spans<F: Fn(&mut Span)>(&mut self, shift: &F)

Apply shift to every Span reachable in self.

impl StructuralPartialEq for Span