antlr3exception.c File Reference

---

Detailed Description

Contains default functions for creating and destroying as well as otherwise handling ANTLR3 standard exception structures.

#include <antlr3exception.h>

Include dependency graph for antlr3exception.c:

Functions
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.

---

Function Documentation

static void antlr3ExceptionFree

(

pANTLR3_EXCEPTION

ex

)

[static]

Frees up a chain of ANTLR3 exceptions.

Parameters:

[in]

ex

Pointer to the first exception in the chain to free.

See also:

ANTLR3_EXCEPTION

References ANTLR3_FREE, 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().

Here is the call graph for this function:

Here is the caller graph for this function:

pANTLR3_EXCEPTION antlr3ExceptionNew	(	ANTLR3_UINT32	exception,
		void *	name,
		void *	message,
		ANTLR3_BOOLEAN	freeMessage
	)

Creates a new ANTLR3 exception structure.

Parameters:

[in]	exception	One of the ANTLR3_xxx_EXCEPTION indicators such as ANTLR3_RECOGNITION_EXCEPTION
[in]	message	Pointer to message string
[in]	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 ANTLR3_CALLOC, 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().

Here is the call graph for this function:

Here is the caller graph for this function:

static void antlr3ExceptionPrint

(

pANTLR3_EXCEPTION

ex

)

[static]

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

Parameters:

[in]

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_FPRINTF, ANTLR3_EXCEPTION_struct::message, ANTLR3_EXCEPTION_struct::nextException, and ANTLR3_EXCEPTION_struct::type.

Referenced by antlr3ExceptionNew().

Here is the caller graph for this function: