org.stekikun.dolmen.unparam

Class Production

java.lang.Object

org.stekikun.dolmen.unparam.Production

public final class Production
extends Object

A grammar production consists of a sequence of production items some of them being actual grammar items (terminals or non-terminals) and others being simply semantic actions.

Actual items can be bound to some identifiers which can be used in the semantic actions.

Author:

Stéphane Lescuyer

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Production.ActionItem Represents a semantic action item, i.e. a semantic action which is performed by the generated parser when the enclosing production rule is executed.
static class	Production.Actual Represents an actual production item, i.e.
static class	Production.Builder Builder class for productions, allows adding production items incrementally
static class	Production.Continue Represents a continuation of the current rule, and unlike the equivalent actual, this allows the generator to produce an optimized tail-recursive call.
static class	Production.Item The base class for production items.
static class	Production.ItemKind Enumeration which describes the different kinds of implementations of Production.Item.

Field Summary

Fields

Modifier and Type	Field and Description
List<Production.Item>	items The list of production items in this production, in order

Constructor Summary

Constructors

Constructor and Description
Production(List<Production.Item> items) Builds a grammar production based on the given parameters

Method Summary

Modifier and Type	Method and Description
Iterable<Production.Actual>	actuals() This does not include potential continuations, although on many aspects they act as actuals.
@Nullable Production.Continue	continuation()
String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

items

public final List<Production.Item> items

The list of production items in this production, in order

Constructor Detail

Production

public Production(List<Production.Item> items)

Builds a grammar production based on the given parameters

Parameters:

items -

Throws:

IllegalArgumentException - if items contains a Production.Continue elsewhere than as the last item

Method Detail

actuals

public Iterable<Production.Actual> actuals()

This does not include potential continuations, although on many aspects they act as actuals.

Returns:

the list of actual production items in this production rule, in the same order as they appear in items

continuation

public @Nullable Production.Continue continuation()

Returns:

the continuation at the end of this production rule if any, and null otherwise

toString

public String toString()

Overrides:

toString in class Object