Package adql.parser

## Class ParseException

- java.lang.Object
- - java.lang.Throwable
  - - java.lang.Exception
    - - adql.parser.ParseException

- All Implemented Interfaces:
    `java.io.Serializable`
  Direct Known Subclasses:
    `UnresolvedColumnException`, `UnresolvedFunctionException`, `UnresolvedIdentifiersException`, `UnresolvedJoinException`, `UnresolvedTableException`

      public class ParseException
      extends java.lang.Exception

  This exception is thrown when parse errors are encountered. You can explicitly create objects of this exception type by calling the method generateParseException in the generated parser. You can modify this class to customize your error reporting mechanisms so long as you retain the public fields.
  See Also:
    Serialized Form

- - ### Field Summary

    Fields
    Modifier and Type | Field | Description
    --- | --- | ---
    `Token` | `currentToken` | This is the last token that has been consumed successfully.
    `protected java.lang.String` | `eol` | The end of line string for this machine.
    `int[][]` | `expectedTokenSequences` | Each entry in this array is an array of integers.
    `protected TextPosition` | `position` | Line in the ADQL query where the exception occurs.
    `java.lang.String[]` | `tokenImage` | This is a reference to the "tokenImage" array of the generated parser within which the parse error occurred.

  - ### Constructor Summary

    Constructors
    Constructor | Description
    --- | ---
    `ParseException()` | The following constructors are for use by you for whatever purpose you can think of.
    `ParseException​(TokenMgrError err)` |
    `ParseException​(Token currentTokenVal, int[][] expectedTokenSequencesVal, java.lang.String[] tokenImageVal)` | This constructor is used by the method "generateParseException" in the generated parser.
    `ParseException​(java.lang.String message)` | Constructor with message.
    `ParseException​(java.lang.String message, TextPosition errorPosition)` |

  - ### Method Summary

    All Methods Instance Methods Concrete Methods
    Modifier and Type | Method | Description
    --- | --- | ---
    `TextPosition` | `getPosition()` | Gets the position in the ADQL query of the token which generates this exception.

    - ### Methods inherited from class java.lang.Throwable

      `addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString`

    - ### Methods inherited from class java.lang.Object

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

- - ### Field Detail

    - #### currentToken

          public Token currentToken

      This is the last token that has been consumed successfully. If this object has been created due to a parse error, the token followng this token will (therefore) be the first error token.

    - #### expectedTokenSequences

          public int[][] expectedTokenSequences

      Each entry in this array is an array of integers. Each array of integers represents a sequence of tokens (by their ordinal values) that is expected at this point of the parse.

    - #### tokenImage

          public java.lang.String[] tokenImage

      This is a reference to the "tokenImage" array of the generated parser within which the parse error occurred. This array is defined in the generated ...Constants interface.

    - #### position

          protected TextPosition position

      Line in the ADQL query where the exception occurs.

    - #### eol

          protected java.lang.String eol

      The end of line string for this machine.

  - ### Constructor Detail

    - #### ParseException

          public ParseException​(Token currentTokenVal,
                                int[][] expectedTokenSequencesVal,
                                java.lang.String[] tokenImageVal)

      This constructor is used by the method "generateParseException" in the generated parser. Calling this constructor generates a new object of this type with the fields "currentToken", "expectedTokenSequences", and "tokenImage" set.

    - #### ParseException

          public ParseException()

      The following constructors are for use by you for whatever purpose you can think of. Constructing the exception in this manner makes the exception behave in the normal way - i.e., as documented in the class "Throwable". The fields "errorToken", "expectedTokenSequences", and "tokenImage" do not contain relevant information. The JavaCC generated code does not use these constructors.

    - #### ParseException

          public ParseException​(java.lang.String message)

      Constructor with message.

    - #### ParseException

          public ParseException​(java.lang.String message,
                                TextPosition errorPosition)

    - #### ParseException

          public ParseException​(TokenMgrError err)

  - ### Method Detail

    - #### getPosition

          public final TextPosition getPosition()

      Gets the position in the ADQL query of the token which generates this exception.
      Returns:
        Position or `null` if unknown.