antlr3exception.c - Man Page

static void antlr3ExceptionFree (pANTLR3_EXCEPTION ex)
Frees up a chain of ANTLR3 exceptions.
pANTLR3_EXCEPTION antlr3ExceptionNew (ANTLR3_UINT32 exception, void *name, void *message, ANTLR3_BOOLEAN freeMessage)
Creates a new ANTLR3 exception structure.
static void antlr3ExceptionPrint (pANTLR3_EXCEPTION ex)
Prints out the message in all the exceptions in the supplied chain.

Frees up a chain of ANTLR3 exceptions.

Parameters

ex Pointer to the first exception in the chain to free.

See also

ANTLR3_EXCEPTION

References ANTLR3_TRUE, ANTLR3_EXCEPTION_struct::custom, ANTLR3_EXCEPTION_struct::freeCustom, ANTLR3_EXCEPTION_struct::freeMessage, ANTLR3_EXCEPTION_struct::message, next(), and ANTLR3_EXCEPTION_struct::nextException.

Referenced by antlr3ExceptionNew().

Creates a new ANTLR3 exception structure.

Parameters

exception One of the ANTLR3_xxx_EXCEPTION indicators such as ANTLR3_RECOGNITION_EXCEPTION
message Pointer to message string
freeMessage Set to ANTLR3_TRUE if the message parameter should be freed by a call to ANTLR3_FREE() when the exception is destroyed.

Returns

Pointer to newly initialized exception structure, or an ANTLR3_ERR_xx defined value upon failure.

An exception is 'thrown' by a recognizer when input is seen that is not predicted by the grammar productions or when some other error condition occurs. In C we do not have the luxury of try and catch blocks, so exceptions are added in the order they occur to a list in the baserecognizer structure. The last one to be thrown is inserted at the head of the list and the one currently installed is pointed to by the newly installed exception.

Remarks

After an exception is created, you may add a pointer to your own structure and a pointer to a function to free this structure when the exception is destroyed.

See also

ANTLR3_EXCEPTION

References antlr3ExceptionFree(), antlr3ExceptionPrint(), ANTLR3_EXCEPTION_struct::freeEx, ANTLR3_EXCEPTION_struct::freeMessage, ANTLR3_EXCEPTION_struct::message, ANTLR3_EXCEPTION_struct::name, ANTLR3_EXCEPTION_struct::print, and ANTLR3_EXCEPTION_struct::type.

Referenced by antlr3RecognitionExceptionNew().

Prints out the message in all the exceptions in the supplied chain.

Parameters

ex Pointer to the exception structure to print.

Remarks

You may wish to override this function by installing a pointer to a new function in the base recognizer context structure.

See also

ANTLR3_BASE_RECOGNIZER

References ANTLR3_EXCEPTION_struct::message, ANTLR3_EXCEPTION_struct::nextException, and ANTLR3_EXCEPTION_struct::type.

Referenced by antlr3ExceptionNew().