Struct Span 

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

A half-open byte range [start, end) in a source file.

Fields

start: BytePos

Inclusive start byte position.

end: BytePos

Exclusive end byte position.

Implementations

impl Span

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

Create a new span.

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

Create a span from raw byte offsets.

pub fn point(pos: BytePos) -> Self

Create a zero-length span at position pos.

pub fn len(self) -> u32

Length in bytes.

pub fn is_empty(self) -> bool

Returns true if this span is empty.

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

Merge two spans into the smallest span covering both.

pub fn contains(self, pos: BytePos) -> bool

Check whether this span contains pos.

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

Slice the source text covered by this span.

Returns None if the span is out of bounds.

pub fn shift(self, n: u32) -> Self

Shift both endpoints by n bytes.

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

fn default() -> Span

Returns the “default value” for a type.

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