Trait Parser

pub trait Parser: Sized {
    type Output;

    // Required method
    fn parse2(self, tokens: TokenStream) -> Result<Self::Output>;

    // Provided methods
    fn parse(self, tokens: TokenStream) -> Result<Self::Output> { ... }
    fn parse_str(self, s: &str) -> Result<Self::Output> { ... }
}

Parser that can parse Rust tokens into a particular syntax tree node.

Refer to the module documentation for details about parsing in Syn.

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

Required Associated Types

type Output

Required Methods

fn parse2(self, tokens: TokenStream) -> Result<Self::Output>

Parse a proc-macro2 token stream into the chosen syntax tree node.

This function will check that the input is fully parsed. If there are any unparsed tokens at the end of the stream, an error is returned.

Provided Methods

fn parse(self, tokens: TokenStream) -> Result<Self::Output>

Parse tokens of source code into the chosen syntax tree node.

This function will check that the input is fully parsed. If there are any unparsed tokens at the end of the stream, an error is returned.

This method is available only if Syn is built with both the "parsing" and "proc-macro" features.

fn parse_str(self, s: &str) -> Result<Self::Output>

Parse a string of Rust code into the chosen syntax tree node.

This function will check that the input is fully parsed. If there are any unparsed tokens at the end of the string, an error is returned.

Hygiene

Every span in the resulting syntax tree will be set to resolve at the macro call site.

Object Safety

This trait is not object safe.

Implementors

impl<F, T> Parser for F

where F: FnOnce(ParseStream<'_>) -> Result<T>,

type Output = T