_ConstChoice_0 Class Reference

_ConstChoice_0 non-terminal symbol class. More...

Inherited Class(es)

• public gsp::Symbol [ virtual ]
• public _ConstChoice_0Composite

• _ConstChoice_0 ( ) 
• virtual ~_ConstChoice_0 ( ) 
• universal::String getSymbolName ( ) const 
• virtual gsp::Symbol & getRightByIndex ( unsigned long uIndex ) 
• virtual bool parseSymbol ( gsp::LLParser & parser , gsp::Symbol * & rpReturnSymbol , gsp::Symbol * pParent = NULL ) 
• bool parseSymbol ( ini::Parser & parser , _ConstChoice_0 * & rpReturnSymbol , gsp::Symbol * pParent = NULL ) 
• bool parseRoot ( ini::Parser & parser , _ConstChoice_0 * & pReturnSymbol , gsp::Symbol * pParent = NULL , bool bBreakOff = true ) 
• virtual bool parse ( std::istream & is , std::ostream & os , gsp::Symbol * pParent = NULL , bool bExpectEOF = false , bool bDeactivatePreprocessing = false ) 
• virtual bool parse ( std::istream & is , gsp::Symbol * pParent = NULL , bool bExpectEOF = false , bool bDeactivatePreprocessing = false ) 
• virtual bool expand ( std::ostream & os , bool bRestoreWS = true ) 
• virtual bool backtrace ( std::ostream & os ) 
• virtual bool visit ( gsp::Visitor & visitor , gsp::Symbol * & pReturnSymbol ) 
• virtual bool test ( std::ostream & os , bool bVerbose = false ) 
• universal::String expand ( bool bTrimFirstWhitespaces = true , bool bRestoreWS = true ) 
• virtual bool isToken ( ) const 
• virtual bool isNonTerminal ( ) const 
• virtual void reset ( ) 

• _ConstChoice_0 * reduce ( ini::Parser & parser ) 
• _ConstChoice_0 * reduce ( const long lRuleRank , ini::Parser & parser ) 
• void initRule ( ) 

• unsigned long getNbRules ( ) const 
• unsigned long getNbSymbolsInRule ( long lRuleRank ) const 
• unsigned long getSymbolDescription ( long lRuleRank , long lSymbolRank ) const 
• virtual const unsigned long * getFirstsDescriptions ( ) const 

• static int maxOccurrences ( ) 
• static int minOccurrences ( ) 
• static void maxOccurrences ( int iMaxOcc ) 
• static void minOccurrences ( int iMinOcc ) 
• static bool is_a ( gsp::Symbol * pSymbol ) 
• static _ConstChoice_0Factory & factory ( ) 
• static void setFactory ( _ConstChoice_0Factory * pNewFactory ) 

• unsigned char m_cWsFlag [ 2 + 1 ] [ 20 ] 
• unsigned short m_uNbWs [ 2 + 1 ] 

• _ConstChoice_0Factory * ms_factory 
• int m_iMaxOccurrences 
• int m_iMinOccurrences 

• unsigned long NB_RULES 
• unsigned long RULES [ 1 ] [ 2 ] 
• unsigned long NB_FIRSTS 
• unsigned long FIRSTS [ 1 + 1 ] 

• class _ConstChoice_0Factory 

Detailed Description

_ConstChoice_0 non-terminal symbol class.

This class provides the generated parse and expand code for a non-terminal.

It also contains the coded description of the rules defined for this non-terminal.

Functions Documentation

Returns the maximum allowed number of occurrences of this symbol or -1 if there is no limit.

See also:

Returns the minimum required number of occurrences of this symbol or -1 if there is no limit.

See also:

Sets the maximum allowed number of occurrences of this symbol. -1 if there is no limit.

See also:

Sets the minimum required number of occurrences of this symbol. -1 if there is no limit.

See also:

Non-terminal symbol class constructor.

See also:

Non-terminal symbol class destructor.

See also:

Tells whether the symbol is token.

See also:

Tells whether the symbol is a non-terminal.

See also:

Please refer to the matching overriden method description in base class.

See also:

Please refer to the matching overriden method description in base class.

See also:

Please refer to the matching overriden method description in base class.

See also:

Please refer to the matching overriden method description in base class.

See also:

Visits the symbol with visitor and returns in pReturnSymbol a pointer to a replacing symbol (if any).

Returns true if the visit was accepted and successful.

See also:

Please refer to the matching overriden method description in base class.

See also:

Used internally by the generated code to carry out the parsing of the symbol.

See also:

This function attempts to carry out a raw parsing of this symbol using parser, without pre-processing the input stream before.

The symbol is parsed as the root symbol would be, i.e. the line numbering in stream starts counting from zero and it is checked that the end of the stream is encountered if a stream break-off was expected.

pReturnSymbol is the symbol pointer returned by the parsing.

pParent gives the initial parent for the symbol parent to parse. By default it is null, i.e. the symbol is the root and has no parent.

bBreakOff tells whether a stream break-off is expected at the end of the parsing (true by default).

Returns true when the symbol could be successfully parsed, regardless of whether user errors were raised from reduction code. For that purpose, the return value of fail() should also always be checked in parallel to handle these errors.

See also:

This function attempts to parse this symbol in a input stream is and error messages are re-directed to output stream os.

pParent gives the initial parent for the symbol parent to parse. By default it is null, i.e. the symbol is the root and has no parent.

bDeactivatePreprocessing tells whether preprocessing should be deactivated before the actual parsing takes place. This argument is optional and is set to false by default.

The symbol is parsed as the root symbol would be, i.e. the line numbering in stream starts counting from zero.

bExpectEOF tells whether to expect an end-of-stream at the end of parsing. This parameter is optional and set to false by default.

This function is useful when the users don't want to parse a stream starting from the root symbol of the grammar, but from whatever else symbol, without having to create by himself the parser object and output possible error messages.

With this function there is no way to get the symbol returned by the reduction code.

Basically, calling this method is equivalent to:

Example:

  ...Parser parser(is);
  ...parser.deactivatePreprocessing(bDeactivatePreprocessing);
  ...parser.preprocess();
  ...parseRoot();

See also:

This overloaded function is provided for convenience and behaves like the above function, except that error messages are forced to be output on the standard error output cerr.

Therefore, it is strictly equivalent to calling:

parse(is, cerr, pParent, bDeactivatePreprocessing)

See also:

Expands the non-terminal. See documentation of overriden method referred to below.

This method ensures the following:

- If the default/normal expanding was ok and it is the root, the original trailing whitespaces are restored.

- If the non-terminal is a composite, the expanding will result of the expanding of all components.

- Return true on success only.

NO end-of-stream char ('\0') is appended to the result string.

See also:

This function is provided for convenience and behaves like the other expand() function, except that :

on failure an empty string is returned;

the first leading whitespaces are removed by default. This can be switched off by setting bTrimFirstWhitespaces to false.

bRestoreWS is also optional and tells whether to restore all whitespaces. This is the case by default. If not so, the value of bTrimFirstWhitespaces is actually overriden and ignored.

See also:

Backtraces the non-terminal.

See also:

Tests the symbol according to the test cases specified along with with the symbol definition.

For further information please see the test() function of the base symbol class.

See also:

Returns the factory object for such non-terminal.

See also:

Sets pNewFactory as the new factory object for such non-terminal.

The previous factory is not destroyed.

See also:

Tells whether the passed symbol pointer narrows to a symbol pointer of this type.

See also:

Returns the name of this non-terminal symbol class.

See also:

Please refer to the matching overriden method description in base class.

See also:

Please refer to the matching overriden method description in base class.

If a rule was reduced for this symbol, all the right symbols appearing in that rule are destroyed/recycled using their respective factory.

If this is a composite symbol, the components are destroyed.

See also:

Initializes the symbol for parsing any of its rule.

See also: