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. | |
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. | |
SAXParseException (const SAXParseException &toCopy) | |
Copy constructor. | |
~SAXParseException () | |
Destructor. | |
Assignment operator | |
SAXParseException & | operator= (const SAXParseException &toAssign) |
Assignment operator. | |
Getter methods | |
XMLFileLoc | getColumnNumber () const |
The column number of the end of the text where the exception occurred. | |
XMLFileLoc | getLineNumber () const |
The line number of the end of the text where the exception occurred. | |
const XMLCh * | getPublicId () const |
Get the public identifier of the entity where the exception occurred. | |
const XMLCh * | getSystemId () const |
Get the system identifier of the entity where the exception occurred. |
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.
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.
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. |
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.
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. |
SAXParseException::SAXParseException | ( | const SAXParseException & | toCopy | ) |
Copy constructor.
toCopy | The object to be copied |
SAXParseException::~SAXParseException | ( | ) |
Destructor.
SAXParseException& SAXParseException::operator= | ( | const SAXParseException & | toAssign | ) |
Assignment operator.
toAssign | The object to be copied through assignment |
XMLFileLoc SAXParseException::getColumnNumber | ( | ) | const |
The column number of the end of the text where the exception occurred.
The first column in a line is position 1.
XMLFileLoc SAXParseException::getLineNumber | ( | ) | const |
The line number of the end of the text where the exception occurred.
const XMLCh* SAXParseException::getPublicId | ( | ) | const |
Get the public identifier of the entity where the exception occurred.
const XMLCh* SAXParseException::getSystemId | ( | ) | const |
Get the system identifier of the entity where the exception occurred.
If the system identifier is a URL, it will be resolved fully.