[][src]Struct syn::Attribute

pub struct Attribute {
    pub pound_token: Pound,
    pub style: AttrStyle,
    pub bracket_token: Bracket,
    pub path: Path,
    pub tts: TokenStream,
}

An attribute like #[repr(transparent)].

This type is available if Syn is built with the "derive" or "full" feature.

Syntax

Rust has six types of attributes.

  • Outer attributes like #[repr(transparent)]. These appear outside or in front of the item they describe.
  • Inner attributes like #![feature(proc_macro)]. These appear inside of the item they describe, usually a module.
  • Outer doc comments like /// # Example.
  • Inner doc comments like //! Please file an issue.
  • Outer block comments /** # Example */.
  • Inner block comments /*! Please file an issue */.

The style field of type AttrStyle distinguishes whether an attribute is outer or inner. Doc comments and block comments are promoted to attributes, as this is how they are processed by the compiler and by macro_rules! macros.

The path field gives the possibly colon-delimited path against which the attribute is resolved. It is equal to "doc" for desugared doc comments. The tts field contains the rest of the attribute body as tokens.

#[derive(Copy)]      #[crate::precondition x < 5]
  ^^^^^^~~~~~~         ^^^^^^^^^^^^^^^^^^^ ~~~~~
   path  tts                   path         tts

Use the parse_meta method to try parsing the tokens of an attribute into the structured representation that is used by convention across most Rust libraries.

Parsing

This type does not implement the Parse trait and thus cannot be parsed directly by ParseStream::parse. Instead use ParseStream::call with one of the two parser functions Attribute::parse_outer or Attribute::parse_inner depending on which you intend to parse.

This code runs with edition 2018
use syn::{Attribute, Ident, Result, Token};
use syn::parse::{Parse, ParseStream};

// Parses a unit struct with attributes.
//
//     #[path = "s.tmpl"]
//     struct S;
struct UnitStruct {
    attrs: Vec<Attribute>,
    struct_token: Token![struct],
    name: Ident,
    semi_token: Token![;],
}

impl Parse for UnitStruct {
    fn parse(input: ParseStream) -> Result<Self> {
        Ok(UnitStruct {
            attrs: input.call(Attribute::parse_outer)?,
            struct_token: input.parse()?,
            name: input.parse()?,
            semi_token: input.parse()?,
        })
    }
}

Fields

pound_token: Poundstyle: AttrStylebracket_token: Bracketpath: Pathtts: TokenStream

Methods

impl Attribute[src]

pub fn parse_meta(&self) -> Result<Meta>[src]

Parses the content of the attribute, consisting of the path and tts, as a Meta if possible.

pub fn parse_outer(input: ParseStream) -> Result<Vec<Self>>[src]

Parses zero or more outer attributes from the stream.

This function is available if Syn is built with the "parsing" feature.

pub fn parse_inner(input: ParseStream) -> Result<Vec<Self>>[src]

Parses zero or more inner attributes from the stream.

This function is available if Syn is built with the "parsing" feature.

Trait Implementations

impl Clone for Attribute[src]

fn clone_from(&mut self, source: &Self)1.0.0[src]

Performs copy-assignment from source. Read more

impl PartialEq<Attribute> for Attribute[src]

#[must_use] fn ne(&self, other: &Rhs) -> bool1.0.0[src]

This method tests for !=.

impl Eq for Attribute[src]

impl Debug for Attribute[src]

impl Hash for Attribute[src]

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher
1.3.0[src]

Feeds a slice of this type into the given [Hasher]. Read more

impl ToTokens for Attribute[src]

fn into_token_stream(self) -> TokenStream[src]

Convert self directly into a TokenStream object. Read more

Auto Trait Implementations

Blanket Implementations

impl<T> Spanned for T where
    T: ToTokens
[src]

impl<T> ToOwned for T where
    T: Clone
[src]

type Owned = T

The resulting type after obtaining ownership.

impl<T> From<T> for T[src]

impl<T, U> Into<U> for T where
    U: From<T>, 
[src]

impl<T, U> TryFrom<U> for T where
    U: Into<T>, 
[src]

type Error = Infallible

The type returned in the event of a conversion error.

impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, 
[src]

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

impl<T> BorrowMut<T> for T where
    T: ?Sized
[src]

impl<T> Borrow<T> for T where
    T: ?Sized
[src]

impl<T> Any for T where
    T: 'static + ?Sized
[src]