Encapsulate an XML parse error or warning. More...

Inheritance diagram for SAXParseException:

Public Member Functions
Constructors and Destructor
	SAXParseException (const XMLCh const message, const Locator &locator, MemoryManager const manager=XMLPlatformUtils::fgMemoryManager)
	Create a new SAXParseException from a message and a Locator. More...

	SAXParseException (const XMLCh const message, const XMLCh const publicId, const XMLCh const systemId, const XMLFileLoc lineNumber, const XMLFileLoc columnNumber, MemoryManager const manager=XMLPlatformUtils::fgMemoryManager)
	Create a new SAXParseException. More...

	SAXParseException (const SAXParseException &toCopy)
	Copy constructor. More...

	~SAXParseException ()
	Destructor. More...

Assignment operator
SAXParseException &	operator= (const SAXParseException &toAssign)
	Assignment operator. More...

Getter methods
XMLFileLoc	getColumnNumber () const
	The column number of the end of the text where the exception occurred. More...

XMLFileLoc	getLineNumber () const
	The line number of the end of the text where the exception occurred. More...

const XMLCh *	getPublicId () const
	Get the public identifier of the entity where the exception occurred. More...

const XMLCh *	getSystemId () const
	Get the system identifier of the entity where the exception occurred. More...

Public Member Functions inherited from SAXException
	SAXException (MemoryManager *const manager=XMLPlatformUtils::fgMemoryManager)
	Default constructor. More...

	SAXException (const XMLCh const msg, MemoryManager const manager=XMLPlatformUtils::fgMemoryManager)
	Create a new SAXException. More...

	SAXException (const char const msg, MemoryManager const manager=XMLPlatformUtils::fgMemoryManager)
	Create a new SAXException. More...

	SAXException (const SAXException &toCopy)
	Copy constructor. More...

virtual	~SAXException ()
	Destructor. More...

SAXException &	operator= (const SAXException &toCopy)
	Assignment operator. More...

virtual const XMLCh *	getMessage () const
	Get the contents of the message. More...

Public Member Functions inherited from XMemory
void *	operator new (size_t size)
	This method overrides operator new. More...

void *	operator new (size_t size, MemoryManager *memMgr)
	This method defines a custom operator new, that will use the provided memory manager to perform the allocation. More...

void *	operator new (size_t size, void *ptr)
	This method overrides placement operator new. More...

void	operator delete (void *p)
	This method overrides operator delete. More...

void	operator delete (void p, MemoryManager memMgr)
	This method provides a matching delete for the custom operator new. More...

void	operator delete (void p, void ptr)
	This method provides a matching delete for the placement new. More...

Additional Inherited Members
Protected Member Functions inherited from XMemory
	XMemory ()
	Protected default constructor. More...

Protected Attributes inherited from SAXException
XMLCh *	fMsg

MemoryManager *	fMemoryManager

Detailed Description

Encapsulate an XML parse error or warning.

This exception will include information for locating the error in the original XML document. Note that although the application will receive a SAXParseException as the argument to the handlers in the ErrorHandler interface, the application is not actually required to throw the exception; instead, it can simply read the information in it and take a different action.

Since this exception is a subclass of SAXException, it inherits the ability to wrap another exception.

See also: SAXException::SAXException; Locator::Locator; ErrorHandler::ErrorHandler

Constructor & Destructor Documentation

SAXParseException::SAXParseException	(	const XMLCh *const	message,
		const Locator &	locator,
		MemoryManager *const	manager = `XMLPlatformUtils::fgMemoryManager`
	)

Create a new SAXParseException from a message and a Locator.

This constructor is especially useful when an application is creating its own exception from within a DocumentHandler callback.

Parameters

message	The error or warning message.
locator	The locator object for the error or warning.
manager	Pointer to the memory manager to be used to allocate objects.

See also: Locator::Locator; Parser::setLocale

SAXParseException::SAXParseException	(	const XMLCh *const	message,
		const XMLCh *const	publicId,
		const XMLCh *const	systemId,
		const XMLFileLoc	lineNumber,
		const XMLFileLoc	columnNumber,
		MemoryManager *const	manager = `XMLPlatformUtils::fgMemoryManager`
	)

Create a new SAXParseException.

This constructor is most useful for parser writers.

If the system identifier is a URL, the parser must resolve it fully before creating the exception.

Parameters

message	The error or warning message.
publicId	The public identifier of the entity that generated the error or warning.
systemId	The system identifier of the entity that generated the error or warning.
lineNumber	The line number of the end of the text that caused the error or warning.
columnNumber	The column number of the end of the text that caused the error or warning.
manager	Pointer to the memory manager to be used to allocate objects.