Python & XML

Name

SAX Exceptions

Synopsis

SAX presents all errors, including exceptions raised by handler methods, to the application as instances of the SAXException exception class or its subclasses. Instances of this class have these methods:

getException( )

Returns an exception caught by the SAX parser, if there was one, or None if there wasn’t one.

getMessage( )

Returns an explanation of the problem encountered by the parser as a string for human consumption. The message string may have been localized if the XMLReader’s setLocale method is called.

The following subclasses of SAXException are defined by SAX.

SAXParseException

This exception is raised when there is a problem parsing the document. Instances of this exception also conform to the Locator interface.

SAXNotRecognizedException

When an application attempts to set or query a feature or property that is not recognized by the parser, this exception is raised. Parsers are required to recognize all features and properties defined as part of the SAX 2 specification, even if they don’t support them.

SAXNotSupportedException

A parser raises this exception when the application attempts to set or query a feature or property that is recognized but not supported, or when the application attempts to set a feature or property to a value that is not supported.