Struct Span 

pub struct Span<'a> {
    pub file: &'a str,
    pub bytes: ByteSpan,
    pub expanded_from: Option<&'a Span<'a>>,
    pub included_from: Option<&'a Span<'a>>,
}

A representation of a unique location in a source file

If the file was included from another file (using the #include directive), Span::included_from will reference the Span of the include directive

If the Span is part of a #define directive, each expanded text macro will have the original Span of the #define token, with Span::expanded_from referencing the macro expansion directive

Fields

file: &'a str

bytes: ByteSpan

expanded_from: Option<&'a Span<'a>>

included_from: Option<&'a Span<'a>>

Implementations

impl<'a> Span<'a>

pub const fn empty() -> Span<'a>

An empty Span

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

Compare two Spans, returning the relationship of the first to the second

let span1 = Span {
    file: "test",
    bytes: ByteSpan { start: 0, end: 2 },
    expanded_from: None,
    included_from: None
};
let span2 = Span {
    file: "test",
    bytes: ByteSpan { start: 6, end: 8 },
    expanded_from: None,
    included_from: None
};
assert_eq!(span1.compare(&span2), SpanRelation::Earlier)

Expanded Spans will be compared starting at their expansion point, and working backwards through #defines. Included Spans will be compared starting at their first #include and working through the include hierarchy to their final token.

Trait Implementations

impl<'a> Clone for Span<'a>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for Span<'a>

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

Formats the value using the given formatter.

impl<'a> Default for Span<'a>

fn default() -> Span<'a>

Returns the “default value” for a type.

impl<'a> PartialEq for Span<'a>

fn eq(&self, other: &Span<'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> Eq for Span<'a>

impl<'a> StructuralPartialEq for Span<'a>