Enum syntex_syntax2::tokenstream::TokenTree

pub enum TokenTree {
    Token(Span, Token),
    Delimited(Span, Delimited),
}

When the main rust parser encounters a syntax-extension invocation, it parses the arguments to the invocation as a token-tree. This is a very loose structure, such that all sorts of different AST-fragments can be passed to syntax extensions using a uniform type.

If the syntax extension is an MBE macro, it will attempt to match its LHS token tree against the provided token tree, and if it finds a match, will transcribe the RHS token tree, splicing in any captured macro_parser::matched_nonterminals into the SubstNts it finds.

The RHS of an MBE macro is the only place SubstNts are substituted. Nothing special happens to misnamed or misplaced SubstNts.

Variants

Token(Span, Token)

A single token

Delimited(Span, Delimited)

A delimited sequence of token trees

Methods

impl TokenTree

pub fn parse(
    cx: &ExtCtxt,
    mtch: &[TokenTree],
    tts: TokenStream
) -> NamedParseResult

Use this token tree as a matcher to parse given tts.

pub fn eq_unspanned(&self, other: &TokenTree) -> bool

Check if this TokenTree is equal to the other, regardless of span information.

pub fn span(&self) -> Span

Retrieve the TokenTree's span.

pub fn eq_token(&self, t: Token) -> bool

Indicates if the stream is a token that is equal to the provided token.

Trait Implementations

impl ToTokens for TokenTree

fn to_tokens(&self, _cx: &ExtCtxt) -> Vec<TokenTree>

impl PartialEq<TokenTree> for TokenTree

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

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

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

This method tests for !=.

impl Clone for TokenTree

fn clone(&self) -> TokenTree

Returns a copy of the value.

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

Performs copy-assignment from source.

impl From<TokenTree> for TokenStream

fn from(tt: TokenTree) -> TokenStream

Performs the conversion.

impl Eq for TokenTree

impl Hash for TokenTree

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, 

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

impl Debug for TokenTree

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for TokenTree

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

Deserialize this value from the given Serde deserializer.

impl Serialize for TokenTree

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

Serialize this value into the given Serde serializer.