# Poco::XML

# class SAXParseException

Library: XML
Package: SAX
Header: Poco/SAX/SAXException.h

## Description

Exception class for an unsupported operation.

An XMLReader will throw this exception when it recognizes a feature or property identifier, but cannot perform the requested operation (setting a state or value). Other SAX2 applications and extensions may use this class for similar purposes. Encapsulate an XML parse error or warning.

This exception may include information for locating the error in the original XML document, as if it came from a Locator object. 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.

## Inheritance

Direct Base Classes: SAXException

All Base Classes: Poco::Exception, Poco::RuntimeException, SAXException, XMLException, std::exception

## Member Summary

Member Functions: buildMessage, className, clone, getColumnNumber, getLineNumber, getPublicId, getSystemId, name, operator =, rethrow

Inherited Functions: className, clone, code, displayText, extendedMessage, message, name, nested, operator =, rethrow, what

## Constructors

### SAXParseException

SAXParseException(
const SAXParseException & exc
);

Creates a new SAXParseException from another one.

### SAXParseException

SAXParseException(
const std::string & msg,
const Locator & loc
);

Create a new SAXParseException from a message and a Locator.

### SAXParseException

SAXParseException(
const std::string & msg,
const Locator & loc,
const Poco::Exception & exc
);

Wrap an existing exception in a SAXParseException.

### SAXParseException

SAXParseException(
const std::string & msg,
const XMLString & publicId,
const XMLString & systemId,
int lineNumber,
int columnNumber
);

Create a new SAXParseException with an embedded exception.

This constructor is most useful for parser writers. All parameters except the message are as if they were provided by a Locator. For example, if the system identifier is a URL (including relative filename), the caller must resolve it fully before creating the exception.

### SAXParseException

SAXParseException(
const std::string & msg,
const XMLString & publicId,
const XMLString & systemId,
int lineNumber,
int columnNumber,
const Poco::Exception & exc
);

Create a new SAXParseException.

This constructor is most useful for parser writers. All parameters except the message are as if they were provided by a Locator. For example, if the system identifier is a URL (including relative filename), the caller must resolve it fully before creating the exception.

## Destructor

### ~SAXParseException

~SAXParseException() noexcept;

Destroy the exception.

## Member Functions

### className

const char * className() const noexcept;

Returns the name of the exception class.

See also: Poco::XML::SAXException::className()

### clone

Poco::Exception * clone() const;

Creates an exact copy of the exception.

### getColumnNumber

int getColumnNumber() const;

The column number of the end of the text where the exception occurred. The first column in a line is position 1.

### getLineNumber

int getLineNumber() const;

The line number of the end of the text where the exception occurred. The first line is line 1.

### getPublicId

const XMLString & getPublicId() const;

Get the public identifier of the entity where the exception occurred.

### getSystemId

const XMLString & getSystemId() const;

Get the system identifier of the entity where the exception occurred.

### name

const char * name() const noexcept;

Returns a static string describing the exception.

See also: Poco::XML::SAXException::name()

### operator =

SAXParseException & operator = (
const SAXParseException & exc
);

Assignment operator.

### rethrow

void rethrow() const;

(Re)Throws the exception.

See also: Poco::XML::SAXException::rethrow()

### buildMessage

static std::string buildMessage(
const std::string & msg,
const XMLString & publicId,
const XMLString & systemId,
int lineNumber,
int columnNumber
);