Struct MultiSpan

#[repr(C)]
pub struct MultiSpan { /* private fields */ }

A collection of spans. Spans have two orthogonal attributes:

• they can be primary spans. In this case they are the locus of the error, and would be rendered with ^^^.
• they can have a label. In this case, the label is written next to the mark in the snippet when we render.

Implementations

impl MultiSpan

pub fn new() -> MultiSpan

pub fn from_span(primary_span: Span) -> MultiSpan

pub fn from_spans(vec: Vec<Span>) -> MultiSpan

pub fn push_span_label(&mut self, span: Span, label: String)

pub fn primary_span(&self) -> Option<Span>

Selects the first primary span (if any)

pub fn primary_spans(&self) -> &[Span]

Returns all primary spans.

pub fn is_dummy(&self) -> bool

Returns true if this contains only a dummy primary span with any hygienic context.

pub fn replace(&mut self, before: Span, after: Span) -> bool

Replaces all occurrences of one Span with another. Used to move Spans in areas that don’t display well (like std macros). Returns true if replacements occurred.

pub fn span_labels(&self) -> Vec<SpanLabel>

Returns the strings to highlight. We always ensure that there is an entry for each of the primary spans – for each primary span P, if there is at least one label with span P, we return those labels (marked as primary). But otherwise we return SpanLabel instances with empty labels.

Trait Implementations

impl Archive for MultiSpan

where Vec<Span>: Archive, Vec<PrimarySpanLabel>: 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 = ArchivedMultiSpan

The archived representation of this type.

type Resolver = MultiSpanResolver

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<__C: Fallible + ?Sized> CheckBytes<__C> for MultiSpan

where <__C as Fallible>::Error: Trace, Vec<Span>: CheckBytes<__C>, Vec<PrimarySpanLabel>: CheckBytes<__C>,

unsafe fn check_bytes( value: *const Self, context: &mut __C, ) -> Result<(), <__C as Fallible>::Error>

Checks whether the given pointer points to a valid value within the given context.

impl Clone for MultiSpan

fn clone(&self) -> MultiSpan

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for MultiSpan

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

Formats the value using the given formatter.

impl Default for MultiSpan

fn default() -> MultiSpan

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for MultiSpan

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<MultiSpan, __D> for Archived<MultiSpan>

where Vec<Span>: Archive, <Vec<Span> as Archive>::Archived: Deserialize<Vec<Span>, __D>, Vec<PrimarySpanLabel>: Archive, <Vec<PrimarySpanLabel> as Archive>::Archived: Deserialize<Vec<PrimarySpanLabel>, __D>,

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

Deserializes using the given deserializer

impl From<Span> for MultiSpan

fn from(span: Span) -> MultiSpan

Converts to this type from the input type.

impl From<Vec<Span>> for MultiSpan

fn from(spans: Vec<Span>) -> MultiSpan

Converts to this type from the input type.

impl Hash for MultiSpan

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 MultiSpan

fn eq(&self, other: &MultiSpan) -> 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> Serialize<__S> for MultiSpan

where Vec<Span>: Serialize<__S>, Vec<PrimarySpanLabel>: 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 Serialize for MultiSpan

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for MultiSpan

impl StructuralPartialEq for MultiSpan