Struct Spanned 

pub struct Spanned<T> {
    pub value: T,
    pub span: Span,
    pub file_id: u16,
}

A value with an associated source location (span and file).

Fields

value: T

The value.

span: Span

The source span (byte offsets within the file).

file_id: u16

The source file ID (index into SourceMap). Uses u16 to minimize struct size (max 65,535 files).

Implementations

impl<T> Spanned<T>

pub const fn new(value: T, span: Span) -> Self

Create a new spanned value with file_id defaulting to 0.

Use with_file_id to set the correct file ID after creation.

pub fn with_file_id(self, file_id: usize) -> Self

Set the file ID for this spanned value.

Accepts usize for API convenience but stores as u16 internally.

Panics

Debug builds will panic if file_id exceeds u16::MAX (65,535).

pub fn map<U, F: FnOnce(T) -> U>(self, f: F) -> Spanned<U>

Map the inner value, preserving span and file_id.

pub const fn inner(&self) -> &T

Get a reference to the inner value.

pub fn into_inner(self) -> T

Unwrap the spanned value, discarding the span and file_id.

Trait Implementations

impl<T> Archive for Spanned<T>

where T: Archive, Span: Archive, u16: Archive,

type Archived = ArchivedSpanned<T>

The archived representation of this type.

type Resolver = SpannedResolver<T>

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.

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.

impl<T: Clone> Clone for Spanned<T>

fn clone(&self) -> Spanned<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for Spanned<T>

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

Formats the value using the given formatter.

impl<'de, T> Deserialize<'de> for Spanned<T>

where T: Deserialize<'de>,

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, T> Deserialize<Spanned<T>, __D> for Archived<Spanned<T>>

where T: Archive, <T as Archive>::Archived: Deserialize<T, __D>, Span: Archive, <Span as Archive>::Archived: Deserialize<Span, __D>, u16: Archive, <u16 as Archive>::Archived: Deserialize<u16, __D>,

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

Deserializes using the given deserializer

impl<T: Display> Display for Spanned<T>

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

Formats the value using the given formatter.

impl<T: PartialEq> PartialEq for Spanned<T>

fn eq(&self, other: &Spanned<T>) -> 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<__S: Fallible + ?Sized, T> Serialize<__S> for Spanned<T>

where T: Serialize<__S>, Span: Serialize<__S>, u16: 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<T> Serialize for Spanned<T>

where T: Serialize,

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl<T: Eq> Eq for Spanned<T>

impl<T> StructuralPartialEq for Spanned<T>