Struct swc_core::ecma::utils::swc_common::source_map::Span

pub struct Span {
    pub lo: BytePos,
    pub hi: BytePos,
    pub ctxt: SyntaxContext,
}

Available on crate features __ecma and __utils only.

Spans represent a region of code, used for error reporting. Positions in spans are absolute positions from the beginning of the source_map, not positions relative to SourceFiles. Methods on the SourceMap can be used to relate spans back to the original source. You must be careful if the span crosses more than one file - you will not be able to use many of the functions on spans in source_map and you cannot assume that the length of the span = hi - lo; there may be space in the BytePos range between files.

Fields

lo: BytePos

hi: BytePos

ctxt: SyntaxContext

Information about where the macro came from, if this piece of code was created by a macro expansion.

Implementations

impl Span

pub fn lo(self) -> BytePos

pub fn new(lo: BytePos, hi: BytePos, ctxt: SyntaxContext) -> Span

pub fn with_lo(&self, lo: BytePos) -> Span

pub fn hi(self) -> BytePos

pub fn with_hi(&self, hi: BytePos) -> Span

pub fn ctxt(self) -> SyntaxContext

pub fn with_ctxt(&self, ctxt: SyntaxContext) -> Span

pub fn is_dummy(self) -> bool

Returns true if this is a dummy span with any hygienic context.

pub fn is_dummy_ignoring_cmt(self) -> bool

Returns true if this is a dummy span with any hygienic context.

pub fn shrink_to_lo(self) -> Span

Returns a new span representing an empty span at the beginning of this span

pub fn shrink_to_hi(self) -> Span

Returns a new span representing an empty span at the end of this span

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

Returns self if self is not the dummy span, and other otherwise.

pub fn contains(self, other: Span) -> bool

Return true if self fully encloses other.

pub fn source_equal(self, other: Span) -> bool

Return true if the spans are equal with regards to the source text.

Use this instead of == when either span could be generated code, and you only care that they point to the same bytes of source text.

pub fn trim_start(self, other: Span) -> Option<Span>

Returns Some(span), where the start is trimmed by the end of other

pub fn to(self, end: Span) -> Span

Return a Span that would enclose both self and end.

pub fn between(self, end: Span) -> Span

Return a Span between the end of self to the beginning of end.

pub fn until(self, end: Span) -> Span

Return a Span between the beginning of self to the beginning of end.

pub fn from_inner_byte_pos(self, start: usize, end: usize) -> Span

pub fn apply_mark(self, mark: Mark) -> Span

pub fn remove_mark(&mut self) -> Mark

pub fn private(self) -> Span

pub fn adjust(&mut self, expansion: Mark) -> Option<Mark>

pub fn glob_adjust( &mut self, expansion: Mark, glob_ctxt: SyntaxContext ) -> Option<Option<Mark>>

pub fn reverse_glob_adjust( &mut self, expansion: Mark, glob_ctxt: SyntaxContext ) -> Option<Option<Mark>>

pub fn has_mark(self, mark: Mark) -> bool

Returns true if self is marked with mark.

Panics if mark is not a valid mark.

pub fn dummy_with_cmt() -> Span

Dummy span, both position are extremely large numbers so they would be ignore by sourcemap, but can still have comments

Trait Implementations

impl Archive for Span

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.

unsafe fn resolve( &self, pos: usize, resolver: <Span as Archive>::Resolver, out: *mut <Span as Archive>::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 copy 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<(), Error>

Formats the value using the given formatter.

impl Default for Span

fn default() -> Span

Returns the “default value” for a type.

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

fn deserialize<__D>( __deserializer: __D ) -> Result<Span, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<__D> Deserialize<Span, __D> for <Span as Archive>::Archived

where __D: Fallible + ?Sized,

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

Deserializes using the given deserializer

impl EqIgnoreSpan for Span

fn eq_ignore_span(&self, _: &Span) -> bool

Always returns true

impl<V> FoldWith<V> for Span

where V: Fold + ?Sized,

fn fold_with(self, v: &mut V) -> Span

Calls a visitor method (v.fold_xxx) with self.

fn fold_children_with(self, v: &mut V) -> Span

Visit children nodes of self with v

impl<V> FoldWith<V> for Span

where V: Fold + ?Sized,

fn fold_with(self, v: &mut V) -> Span

Calls a visitor method (v.fold_xxx) with self.

fn fold_children_with(self, v: &mut V) -> Span

Visit children nodes of self with v

impl From<(BytePos, BytePos)> for Span

fn from(sp: (BytePos, BytePos)) -> Span

Converts to this type from the input type.

impl From<Span> for (BytePos, BytePos)

fn from(sp: Span) -> (BytePos, BytePos)

Converts to this type from the input type.

impl From<Span> for MultiSpan

fn from(span: Span) -> MultiSpan

Converts to this type from the input type.

impl Hash for Span

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

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

fn cmp(&self, other: &Span) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized + PartialOrd,

Restrict a value to a certain interval.

impl PartialEq for Span

fn eq(&self, other: &Span) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for Span

fn partial_cmp(&self, other: &Span) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl<__S> Serialize<__S> for Span

where __S: Fallible + ?Sized,

fn serialize( &self, serializer: &mut __S ) -> Result<<Span 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 Span

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Spanned for Span

fn span(&self) -> Span

Get span of self.

fn span_lo(&self) -> BytePos

fn span_hi(&self) -> BytePos

impl Take for Span

fn dummy() -> Span

Create a dummy value of this type.

fn take(&mut self) -> Self

fn map_with_mut<F>(&mut self, op: F)

where F: FnOnce(Self) -> Self,

Mutate self using op, which accepts owned data.

impl TypeEq for Span

fn type_eq(&self, _: &Span) -> bool

Always returns true

impl<V> VisitAllWith<V> for Span

where V: VisitAll + ?Sized,

fn visit_all_with(&self, v: &mut V)

Calls a visitor method (v.visit_xxx) with self.

fn visit_all_children_with(&self, _visitor: &mut V)

Visit children nodes of self with v

impl<V> VisitAllWith<V> for Span

where V: VisitAll + ?Sized,

fn visit_all_with(&self, v: &mut V)

Calls a visitor method (v.visit_xxx) with self.

fn visit_all_children_with(&self, _visitor: &mut V)

Visit children nodes of self with v

impl<V> VisitMutWith<V> for Span

where V: VisitMut + ?Sized,

fn visit_mut_with(&mut self, v: &mut V)

Calls a visitor method (v.visit_mut_xxx) with self.

fn visit_mut_children_with(&mut self, _visitor: &mut V)

impl<V> VisitMutWith<V> for Span

where V: VisitMut + ?Sized,

fn visit_mut_with(&mut self, v: &mut V)

Calls a visitor method (v.visit_mut_xxx) with self.

fn visit_mut_children_with(&mut self, _visitor: &mut V)

impl<V> VisitWith<V> for Span

where V: Visit + ?Sized,

fn visit_with(&self, v: &mut V)

Calls a visitor method (v.visit_xxx) with self.

fn visit_children_with(&self, _visitor: &mut V)

Visit children nodes of self with v

impl<V> VisitWith<V> for Span

where V: Visit + ?Sized,

fn visit_with(&self, v: &mut V)

Calls a visitor method (v.visit_xxx) with self.

fn visit_children_with(&self, _visitor: &mut V)

Visit children nodes of self with v

impl Copy for Span

impl Eq for Span

impl StructuralPartialEq for Span