Trait darling::FromMeta [−][src]
pub trait FromMeta { fn from_nested_meta(item: &NestedMeta) -> Result<Self, Error> { ... } fn from_meta(item: &Meta) -> Result<Self, Error> { ... } fn from_word() -> Result<Self, Error> { ... } fn from_list(items: &[NestedMeta]) -> Result<Self, Error> { ... } fn from_value(value: &Lit) -> Result<Self, Error> { ... } fn from_char(value: char) -> Result<Self, Error> { ... } fn from_string(value: &str) -> Result<Self, Error> { ... } fn from_bool(value: bool) -> Result<Self, Error> { ... } }
Expand description
Create an instance from an item in an attribute declaration.
Implementing FromMeta
- Do not take a dependency on the
ident
of the passed-in meta item. The ident will be set by the field name of the containing struct. - Implement only the
from_*
methods that you intend to support. The default implementations will return useful errors.
Provided Implementations
bool
- Word with no value specified - becomes
true
. - As a boolean literal, e.g.
foo = true
. - As a string literal, e.g.
foo = "true"
.
char
- As a char literal, e.g.
foo = '#'
. - As a string literal consisting of a single character, e.g.
foo = "#"
.
String
- As a string literal, e.g.
foo = "hello"
. - As a raw string literal, e.g.
foo = r#"hello "world""#
.
Number
- As a string literal, e.g.
foo = "-25"
. - As an unquoted positive value, e.g.
foo = 404
. Negative numbers must be in quotation marks.
()
- Word with no value specified, e.g.
foo
. This is best used withOption
. Seedarling::util::Flag
for a more strongly-typed alternative.
Option
- Any format produces
Some
.
Result<T, darling::Error>
- Allows for fallible parsing; will populate the target field with the result of the parse attempt.
Provided methods
fn from_nested_meta(item: &NestedMeta) -> Result<Self, Error>
[src]
fn from_nested_meta(item: &NestedMeta) -> Result<Self, Error>
[src]fn from_meta(item: &Meta) -> Result<Self, Error>
[src]
fn from_meta(item: &Meta) -> Result<Self, Error>
[src]Create an instance from a syn::Meta
by dispatching to the format-appropriate
trait function. This generally should not be overridden by implementers.
Error Spans
If this method is overridden and can introduce errors that weren’t passed up from
other from_meta
calls, the override must call with_span
on the error using the
item
to make sure that the emitted diagnostic points to the correct location in
source code.
fn from_word() -> Result<Self, Error>
[src]
fn from_word() -> Result<Self, Error>
[src]Create an instance from the presence of the word in the attribute with no additional options specified.
fn from_list(items: &[NestedMeta]) -> Result<Self, Error>
[src]
fn from_list(items: &[NestedMeta]) -> Result<Self, Error>
[src]Create an instance from a list of nested meta items.
fn from_value(value: &Lit) -> Result<Self, Error>
[src]
fn from_value(value: &Lit) -> Result<Self, Error>
[src]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.
Error Spans
If this method is overridden, the override must make sure to add value
’s span
information to the returned error by calling with_span(value)
on the Error
instance.
Implementations on Foreign Types
impl FromMeta for Vec<u64, Global>
[src]
impl FromMeta for Vec<u64, Global>
[src]Parsing an unsigned integer array, i.e. example = "[1, 2, 3, 4]"
.
impl FromMeta for LitByteStr
[src]
impl FromMeta for LitByteStr
[src]pub fn from_value(value: &Lit) -> Result<LitByteStr, Error>
[src]
impl<T> FromMeta for Result<T, Meta> where
T: FromMeta,
[src]
impl<T> FromMeta for Result<T, Meta> where
T: FromMeta,
[src]Parses the meta-item, and in case of error preserves a copy of the input for later analysis.
impl FromMeta for Vec<u32, Global>
[src]
impl FromMeta for Vec<u32, Global>
[src]Parsing an unsigned integer array, i.e. example = "[1, 2, 3, 4]"
.
impl FromMeta for ExprArray
[src]
impl FromMeta for ExprArray
[src]Parsing support for an array, i.e. example = "[1 + 2, 2 - 2, 3 * 4]"
.
impl FromMeta for Vec<u8, Global>
[src]
impl FromMeta for Vec<u8, Global>
[src]Parsing an unsigned integer array, i.e. example = "[1, 2, 3, 4]"
.
impl FromMeta for Vec<u16, Global>
[src]
impl FromMeta for Vec<u16, Global>
[src]Parsing an unsigned integer array, i.e. example = "[1, 2, 3, 4]"
.
impl<T, P> FromMeta for Punctuated<T, P> where
P: Parse,
T: Parse,
[src]
impl<T, P> FromMeta for Punctuated<T, P> where
P: Parse,
T: Parse,
[src]Parsing support for punctuated. This attempts to preserve span information when available, but also supports parsing strings with the call site as the emitted span.
pub fn from_value(value: &Lit) -> Result<Punctuated<T, P>, Error>
[src]
impl FromMeta for Vec<WherePredicate, Global>
[src]
impl FromMeta for Vec<WherePredicate, Global>
[src]pub fn from_string(value: &str) -> Result<Vec<WherePredicate, Global>, Error>
[src]
impl FromMeta for Path
[src]
impl FromMeta for Path
[src]Parsing support for paths. This attempts to preserve span information when available, but also supports parsing strings with the call site as the emitted span.
impl FromMeta for Ident
[src]
impl FromMeta for Ident
[src]Parsing support for identifiers. This attempts to preserve span information when available, but also supports parsing strings with the call site as the emitted span.
impl FromMeta for WhereClause
[src]
impl FromMeta for WhereClause
[src]pub fn from_string(value: &str) -> Result<WhereClause, Error>
[src]
impl FromMeta for Vec<usize, Global>
[src]
impl FromMeta for Vec<usize, Global>
[src]Parsing an unsigned integer array, i.e. example = "[1, 2, 3, 4]"
.
impl FromMeta for AtomicBool
[src]
impl FromMeta for AtomicBool
[src]