Module org.kink_lang.kink

Package org.kink_lang.kink.internal.program.ast

Class Parser

java.lang.Object

org.kink_lang.kink.internal.program.ast.Parser

public class Parser
extends Object

A parser of Kink programs. The parser converts a list of tokens to an AST.

Constructor Summary

Constructors

Constructor	Description
Parser(Locale locale)	Constructs a parser.

Method Summary

Modifier and Type	Method	Description
<T> T	parse(List<Token> tokens, Function<? super SeqExpr,? extends T> onSucc, Function3<? super String,? super Integer,? super Integer,? extends T> onError)	Parses the token list to produce an AST.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

Parser

public Parser(Locale locale)

Constructs a parser.

Parameters:

locale - the locale for error messages.

Method Details

parse

public <T> T parse(List<Token> tokens,
 Function<? super SeqExpr,? extends T> onSucc,
 Function3<? super String,? super Integer,? super Integer,? extends T> onError)

Parses the token list to produce an AST.

When parsing succeeds, the method calls onSucc with the AST and returns its result.

When parsing results in an error, the method calls onError with the message, startPos, and endPos, then returns its result.

The last element of tokens must be an instance of EotToken or ErrorToken.

Type Parameters:

T - the result type of onSucc and onError.

Parameters:

tokens - the token list of a Kink program.

onSucc - called when the parsing succeeds.

onError - called when the parsing results in a compile error.

Returns:

the result of onSucc or onError.

Throws:

IllegalArgumentException - when the last element of the tokens argument is not an EotToken nor an ErrorToken.