Struct darling_core::util::SpannedValue

pub struct SpannedValue<T> { /* fields omitted */ }

A value and an associated position in source code. The main use case for this is to preserve position information to emit warnings from proc macros. You can use a SpannedValue<T> as a field in any struct that implements or derives any of darling's core traits.

To access the underlying value, use the struct's Deref implementation.

Defaulting

This type is meant to be used in conjunction with attribute-extracted options, but the user may not always explicitly set those options in their source code. In this case, using Default::default() will create an instance which points to Span::call_site().

Methods

impl<T> SpannedValue<T>

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

pub fn span(&self) -> Span

Get the source code location referenced by this struct.

Trait Implementations

impl<T: FromDeriveInput> FromDeriveInput for SpannedValue<T>

fn from_derive_input(value: &DeriveInput) -> Result<Self>

Create an instance from syn::DeriveInput, or return an error.

impl<T: FromField> FromField for SpannedValue<T>

fn from_field(value: &Field) -> Result<Self>

impl<T: FromGenericParam> FromGenericParam for SpannedValue<T>

fn from_generic_param(value: &GenericParam) -> Result<Self>

impl<T: FromGenerics> FromGenerics for SpannedValue<T>

fn from_generics(value: &Generics) -> Result<Self>

impl<T: FromMeta> FromMeta for SpannedValue<T>

fn from_meta(value: &Meta) -> Result<Self>

Create an instance from a syn::Meta by dispatching to the format-appropriate trait function. This generally should not be overridden by implementers.

fn from_nested_meta(item: &NestedMeta) -> Result<Self>

fn from_word() -> Result<Self>

Create an instance from the presence of the word in the attribute with no additional options specified.

fn from_list(items: &[NestedMeta]) -> Result<Self>

Create an instance from a list of nested meta items.

fn from_value(value: &Lit) -> Result<Self>

Create an instance from a literal value of either foo = "bar" or foo("bar"). This dispatches to the appropriate method based on the type of literal encountered, and generally should not be overridden by implementers.

fn from_char(value: char) -> Result<Self>

Create an instance from a char literal in a value position.

fn from_string(value: &str) -> Result<Self>

Create an instance from a string literal in a value position.

fn from_bool(value: bool) -> Result<Self>

Create an instance from a bool literal in a value position.

impl<T: FromTypeParam> FromTypeParam for SpannedValue<T>

fn from_type_param(value: &TypeParam) -> Result<Self>

impl<T: FromVariant> FromVariant for SpannedValue<T>

fn from_variant(value: &Variant) -> Result<Self>

Create an instance from syn::Variant, or return an error.

impl<T: Default> Default for SpannedValue<T>

fn default() -> Self

Returns the "default value" for a type.

impl<T: Clone> Clone for SpannedValue<T>

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

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T> AsRef<T> for SpannedValue<T>

fn as_ref(&self) -> &T

Performs the conversion.

impl<T: Spanned> From<T> for SpannedValue<T>

fn from(value: T) -> Self

Performs the conversion.

impl<T> DerefMut for SpannedValue<T>

fn deref_mut(&mut self) -> &mut T

Mutably dereferences the value.

impl<T> Deref for SpannedValue<T>

type Target = T

The resulting type after dereferencing.

fn deref(&self) -> &T

Dereferences the value.

impl<T: Debug> Debug for SpannedValue<T>

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

Formats the value using the given formatter.