Struct ttk91::symbolic::parser::Parser

pub struct Parser<'a, T = SymbolTable> {
    pub state: State<T>,
    // some fields omitted
}

Type for parsing symbolic TTK91 programs.

Fields

state: State<T>

Implementations

impl<'a> Parser<'a, SymbolTable>

pub fn from_str(input: &'a str) -> Self

Runs the provided input string through a tokenizer and creates a parser from the resulting tokens stream.

impl<'a, T> Parser<'a, T>

pub fn with_symbol_table<T2>(self, symbol_table: T2) -> Parser<'a, T2>

Replaces the parser's symbol table with the provided one.

pub fn set_logger(&mut self, logger: &Logger)

Sets the Logger used by the Parser to the provided one.

impl<'t> Parser<'t, SymbolTable>

pub fn parse_instruction(input: &'t str) -> Result<Instruction>

Parses a single instruction from the input stream.

impl<'t, T> Parser<'t, T> where
    T: BorrowMut<SymbolTable>, 

pub fn parse_line(&mut self) -> Result<'t, (Option<SymbolId>, Instruction)>

Parse a single line of assembly. This includes a possible label and an instruction.

pub fn parse(&mut self) -> Result<'t, Program>

Tries to parse a program written in symbolic TTK91 assembly. Fails on the first encountered error and returns it.

pub fn parse_verbose(
    &mut self
) -> Result<Program, (Option<Program>, Vec<ParseError<'t>>)>

Like Parser::parse, tries to parse a program written in symbolic TTK91 assembly. Unlike Parser::parse, this function tries it's best to recover from any syntax errors in order to provide suggestions on how to fix these errors and continue parsing further.

pub fn take_opcode(&mut self) -> Result<'t, OpCode>

Takes an OpCode from the input stream.

pub fn take_instruction(&mut self) -> Result<'t, Instruction>

Tries to parse an instruction, which can be either pseudo or concrete.

Trait Implementations

impl<'a, T> Parser<Token<'a>> for Parser<'a, T>

type Stream = BufferedStream<SpannedIter<'a, Token<'a>>>

The token stream type on which the parser operates.

fn stream(&self) -> &Self::Stream

Returns an immutable reference to the stream.

fn stream_mut(&mut self) -> &mut Self::Stream

Returns a mutable reference to the stream.

fn boundary_right(&mut self) -> usize

Returns the start offset of the next token. Can be used together with Parser::boundary_left to find the span of a token stream.

fn boundary_left(&mut self) -> usize

Returns the ending offset of the previous token. Can be used together with Parser::boundary_right to find the span of a token stream.

fn apply<P, O, C>(&mut self, op: P) -> Result<O, ParseError<C, T>> where
    Self: Sized,
    P: Operation<Self, O, C, T>, 

Applies the given parsing operation to the token stream, returning it's result. If the operation fails, reverts the token stream to its original position.

fn take_token<X>(&mut self, token: T) -> Result<T, ParseError<X, T>> where
    T: Display + PartialEq,
    Self: Sized, 

Consumes the specified token from the token stream and returns it. If the next token in the stream is not the wanted token, returns an error.

fn assert_token<X>(&mut self, token: T) -> Result<(), ParseError<X, T>> where
    T: Display + PartialEq,
    Self: Sized, 

Consumes the specified token from the token stream. If the next token in the stream is not the wanted token, returns an error.