Package org.petitparser.tools

Class GrammarDefinition

java.lang.Object

org.petitparser.tools.GrammarDefinition

public class GrammarDefinition
extends Object

Helper to conveniently define and build complex, recursive grammars using plain Java code.

To create a new grammar definition subclass GrammarDefinition. For every production call def(String, Parser) giving the parsers a name. The start production should be named 'start'.

To refer to other productions use ref(String). To redefine or attach actions to productions use redef(String, Function), redef(String, org.petitparser.parser.Parser) and action(String, Function).

To build the resulting grammar call build(), or wrap it in the class GrammarParser.

Constructor Summary

Constructors

Constructor	Description
GrammarDefinition()

Method Summary

Modifier and Type	Method	Description
protected <S,T> void	action(String name, Function<S,T> function)	Attaches an action function to an existing production name.
Parser	build()	Builds a parser starting from the production "start".
Parser	build(String name)	Builds a parser starting from the provided production name.
protected void	def(String name, Parser parser)	Defines a production with a name and a parser.
protected void	redef(String name, Function<Parser,Parser> function)	Redefines an existing production with a name and a function producing a new parser.
protected void	redef(String name, Parser parser)	Redefines an existing production with a name and a new parser.
protected Parser	ref(String name)	Returns a reference to the production with the given name.

Methods inherited from class java.lang.Object

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

Constructor Detail

GrammarDefinition

public GrammarDefinition()

Method Detail

ref

protected final Parser ref(String name)

Returns a reference to the production with the given name.

def

protected final void def(String name,
                         Parser parser)

Defines a production with a name and a parser.

redef

protected final void redef(String name,
                           Parser parser)

Redefines an existing production with a name and a new parser.

redef

protected final void redef(String name,
                           Function<Parser,Parser> function)

Redefines an existing production with a name and a function producing a new parser. Only call this method during initialization.

action

protected final <S,T> void action(String name,
                                  Function<S,T> function)

Attaches an action function to an existing production name. Only call this method during initialization.

build

public Parser build()

Builds a parser starting from the production "start".

build

public Parser build(String name)

Builds a parser starting from the provided production name.