class Racc::Parser

Super Class

Object

Instance Methods

: do_parse -> Object

The entry point of parser. This method is used with #next_token.
If Racc wants to get token (and its value), calls next_token.

  --
  # Example
  ---- inner
    def parse
      @q = [[1,1],
            [2,2],
            [3,3],
            [false, '$']]
      do_parse
    end

    def next_token
      @q.shift
    end
  --

: next_token -> [Symbol, Object]

[abstract method]

The method to fetch next token.  If you use #do_parse method,
you must implement #next_token.  The format of return value is
[TOKEN_SYMBOL, VALUE].  token-symbol is represented by Ruby's symbol
by default, e.g. :IDENT for 'IDENT'.  ";" (String) for ';'.

The final symbol (End of file) must be false.

: yyparse( receiver, method_id )

The another entry point of parser.
If you use this method, you must implement RECEIVER#METHOD_ID method.

RECEIVER#METHOD_ID is a method to get next token.
It must 'yield's token, which format is [TOKEN-SYMBOL, VALUE].

: on_error( error_token_id, error_value, value_stack )

This method is called when parse error is found.

ERROR_TOKEN_ID is an internal ID of token which caused error.
You can get string replesentation of this ID by calling
#token_to_str.

ERROR_VALUE is a value of error token.

value_stack is a stack of symbol values.
DO NOT MODIFY this object.

This method raises ParseError by default.

If this method returns, parsers enter "error recovering mode".

: token_to_str( t ) -> String

Convert internal ID of token symbol to the string.

: yyerror

Enter error recovering mode.
This method does not call #on_error.

: yyerrok

Leave error recovering mode.

: yyaccept

Exit parser.
Return value is Symbol_Value_Stack[0].