org.vishia.zbnf

Class ZbnfParser.PrescriptParser

java.lang.Object

org.vishia.zbnf.ZbnfParser.PrescriptParser

Enclosing class:

ZbnfParser

class ZbnfParser.PrescriptParser
extends java.lang.Object

Class to organize parsing of a component with a own prescript. It is the outer class of the working class ZbnfParser.PrescriptParser.SubParser.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
(package private) class	ZbnfParser.PrescriptParser.SubParser To parse nested syntax, for every level a subparser is created.

Field Summary

Fields

Modifier and Type	Field and Description
(package private) int[]	idxWholeParserStoreForInsertionsFromOuterToInnerLevels This array contains some indices to insert the parseResultsFromOuterToInnerLevels for successfull parsed components.
protected StringPartScan	input The actual input stream.
(package private) ZbnfParseResultItem[]	parentInWholeParserStoreForInsertionsFromOuterToInnerLevels
(package private) ZbnfParser.PrescriptParser	parentPrescriptParser
(package private) ZbnfParserStore	parseResultToOtherComponent An additional parser store to accumulate parse results, which are transfered into the next deeper level of any next component.
(package private) ZbnfParserStore	parserStoreInPrescript The parse result buffer is a own reference in each subParser.
protected int	posInputbase Position where the input String is located in the whole input.
(package private) ZbnfParser.ParseResultlet	resultlet
protected int[]	srcColumnOption
protected int	srcLineOption Position in source on the first parsed item in an option, used if a component is used inside the option and only a constant character item is given before.
protected long	srcPosOption
(package private) java.lang.String	sReportParentComponents A string representing the parent components.
(package private) java.lang.String	sSemanticIdent

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	PrescriptParser(ZbnfParser.PrescriptParser parent, ZbnfSyntaxPrescript syntax, java.lang.String sSemantic, StringPartScan input, int posInputbase)

Method Summary

Modifier and Type	Method and Description
boolean	parsePrescript1(java.lang.String sSemanticForStoring, ZbnfSyntaxPrescript parentSyntaxItem, ZbnfParserStore.ParseResultItemImplement parentResultItem, ZbnfParserStore parserStoreInPrescriptP, ZbnfParserStore parseResultsFromOtherComponents, boolean bSkipSpaceAndComment, boolean bDoNotStoreData, int nRecursion) Parses the syntax-prescript assigned with this class.

Methods inherited from class java.lang.Object

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

Field Detail

resultlet

final ZbnfParser.ParseResultlet resultlet

input

protected final StringPartScan input

The actual input stream. By calling parse recursively, a new SubParser instance is created, but the references to the same input and parse result are assigend. By using the Parser for another parsing execution, a new input and parseResult is used.

posInputbase

protected final int posInputbase

Position where the input String is located in the whole input.

srcLineOption

protected int srcLineOption

Position in source on the first parsed item in an option, used if a component is used inside the option and only a constant character item is given before.

srcColumnOption

protected final int[] srcColumnOption

srcPosOption

protected long srcPosOption

parentPrescriptParser

final ZbnfParser.PrescriptParser parentPrescriptParser

parserStoreInPrescript

ZbnfParserStore parserStoreInPrescript

The parse result buffer is a own reference in each subParser. If the parsed component is to be added in the main stream (the normal case), this pointer points to the parents parseResultBuffer which is the parse result buffer at first level, the main buffer. But if the component parsed here is to be added later, with syntax prescript <...?-...>, the parseResultBuffer is a local instance here.

parseResultToOtherComponent

ZbnfParserStore parseResultToOtherComponent

An additional parser store to accumulate parse results, which are transfered into the next deeper level of any next component. If it is used first, it is initialized.

idxWholeParserStoreForInsertionsFromOuterToInnerLevels

int[] idxWholeParserStoreForInsertionsFromOuterToInnerLevels

This array contains some indices to insert the parseResultsFromOuterToInnerLevels for successfull parsed components.

parentInWholeParserStoreForInsertionsFromOuterToInnerLevels

ZbnfParseResultItem[] parentInWholeParserStoreForInsertionsFromOuterToInnerLevels

sSemanticIdent

final java.lang.String sSemanticIdent

sReportParentComponents

final java.lang.String sReportParentComponents

A string representing the parent components.

Constructor Detail

PrescriptParser

protected PrescriptParser(ZbnfParser.PrescriptParser parent,
                          ZbnfSyntaxPrescript syntax,
                          java.lang.String sSemantic,
                          StringPartScan input,
                          int posInputbase)

Method Detail

parsePrescript1

public boolean parsePrescript1(java.lang.String sSemanticForStoring,
                               ZbnfSyntaxPrescript parentSyntaxItem,
                               ZbnfParserStore.ParseResultItemImplement parentResultItem,
                               ZbnfParserStore parserStoreInPrescriptP,
                               ZbnfParserStore parseResultsFromOtherComponents,
                               boolean bSkipSpaceAndComment,
                               boolean bDoNotStoreData,
                               int nRecursion)
                        throws java.text.ParseException

Parses the syntax-prescript assigned with this class. This routine should be called only one time with a new instance of SubParser. But some instances of SubParser may be created in nested levels. The input is given in the constructor, calld from the outer class ZbnfParser. It is running in a while()-loop. The loop breaks at end of syntax-prescript or if no path in syntax prescript matches to the input. Inside the method ZbnfParser.PrescriptParser.SubParser#parse_Component(StringPartScan, int, String, String, boolean, boolean, boolean) this method may be called recursively, if the syntax prescript contains <syntax...>.
If a semantic for storing is given as input argument sSemanticForStoring, or the syntax prescript have a semantic itself, a parse result is stored as a component for this sub parsing. A semantic as input argument is given if this call results of <syntax...>. A semantic itself is given if the prescript starts with <?syntax> at example in option brackets [<?syntax>... or repeat brackets {<?syntax>... or also possible at start of an nested prescript ::=<?syntax>... Everytime at first the whitespaces and comments are skipped over before the matching of the input to the syntax prescript is tested. The mode of skipping whitespace and comments may be setted by calling setSkippingComment(), setSkippingWhitespace() and setSkippingEndlineComment(), see there.
If the syntax prescript contains a semantic, this is at example by [<?semantic>...], a parse result is written, containing the semantic and the nr of choice if there are some alternatives. Also an empty option is considered.

Parameters:

sSemanticForErrorP - The semantic superior semantic. This semantic is used for error report.

resultType - type of the result item of this component. It may one of ParserStore.kOption etc or a less positiv or negativ number used for repetition and backward repetition.

sSemanticForStoring - The semantic given at the calling item. It may be

• null: No parse result item is created for this level of syntax component. In ZBNF this behavior is forced with noting <component?> by using the component.
• an identifier: A parse result item is created in the parsers result with this given semantic.
• an identifier started with an @: The same as a normal identifier, but in XML output a attribute is created instead an element.
• The string "@": The own semantic of the component is used. The semantic of the component is either identical with the name of the component, or it is defined in ZBNF with the construct component::=<?semantic>. This is the regulary case for mostly calls of syntax component, especially in ZBNF via the simple <syntax>.
  It is possible that the components semantic is null, in this case no parse result item is created for this level. A null-semantic of the component is given in ZBNF via construct component::=<?>. For transforming ZBNF a SyntaxPrescript see @see SyntaxPrescript.convertSyntaxDefinition(StringPart spInput) If not own semantic of the component is defined,

bSkipSpaceAndComment - if true, than white spaces or comments are possible at actual input positions and should be skipped before test a non-terminate syntax and should be skipped after test a terminate syntax if its failed.

parseResultsFromOuterLevel -

addParseResultsFromOuterLevel - List of Buffers with a outer parse result, it should be written in the parseResult buffer after insertion of parseResult.addAlternative() for this component.

Returns:

true if successfully, false on error.

Throws:

java.text.ParseException