Trait Parse

pub trait Parse: Sized {
    // Required method
    fn parse(
        &self,
        input: &mut Context<impl Stream>,
    ) -> Result<Box<dyn Tree>, String>;

    // Provided method
    fn parse_stream<I: Stream>(self, input: I) -> ParseStream<Self, I> { ... }
}

Parse a Stream.

Required Methods

fn parse( &self, input: &mut Context<impl Stream>, ) -> Result<Box<dyn Tree>, String>

Read input Trees from input and try to make a single output tree.

Special cases:

• An unrecognised input tree should be passed on unchanged.
  • In particular, EndOfFile should be passed on unchanged. It must never be incorporated into a larger parse tree.
• If this parser finds a parse error, abandon the current parse tree and return Err(message).
• If input reports a parse error, abandon the current parse tree and pass on the error unchanged.
  • In particular, if input reports an incomplete file, pass it on.

Provided Methods

fn parse_stream<I: Stream>(self, input: I) -> ParseStream<Self, I>

Read Tokens from input to make a Stream of output Tokens.

To make each output Token, the returned Stream calls parse() to make a Tree, and annotates it with a Location.

Object Safety

This trait is not object safe.

Implementors

impl Parse for welly_parser::expr::Parser

impl Parse for welly_parser::lexer::Parser

impl Parse for welly_parser::stmt::Parser

impl Parse for welly_parser::word::Parser

impl<'a> Parse for &'a welly_parser::word::Parser