8.12.1 XMLReader Objects

8.12.1 XMLReader Objects

The XMLReader interface supports the following methods:

parse(

source)

Process an input source, producing SAX events. The source object can be a system identifier (a string identifying the input source - typically a file name or an URL), a file-like object, or an InputSource object. When parse() returns, the input is completely processed, and the parser object can be discarded or reset. As a limitation, the current implementation only accepts byte streams; processing of character streams is for further study.

getContentHandler(

)

Return the current ContentHandler.

setContentHandler(

handler)

Set the current ContentHandler. If no ContentHandler is set, content events will be discarded.

getDTDHandler(

)

Return the current DTDHandler.

setDTDHandler(

handler)

Set the current DTDHandler. If no DTDHandler is set, DTD events will be discarded.

getEntityResolver(

)

Return the current EntityResolver.

setEntityResolver(

handler)

Set the current EntityResolver. If no EntityResolver is set, attempts to resolve an external entity will result in opening the system identifier for the entity, and fail if it is not available.

getErrorHandler(

)

Return the current ErrorHandler.

setErrorHandler(

handler)

Set the current error handler. If no ErrorHandler is set, errors will be raised as exceptions, and warnings will be printed.

setLocale(

locale)

Allow an application to set the locale for errors and warnings.

SAX parsers are not required to provide localization for errors and warnings; if they cannot support the requested locale, however, they must throw a SAX exception. Applications may request a locale change in the middle of a parse.

getFeature(

featurename)

Return the current setting for feature featurename. If the feature is not recognized, SAXNotRecognizedException is raised. The well-known featurenames are listed in the module xml.sax.handler.

setFeature(

featurename, value)

Set the featurename to value. If the feature is not recognized, SAXNotRecognizedException is raised. If the feature or its setting is not supported by the parser, SAXNotSupportedException is raised.

getProperty(

propertyname)

Return the current setting for property propertyname. If the property is not recognized, a SAXNotRecognizedException is raised. The well-known propertynames are listed in the module xml.sax.handler.

setProperty(

propertyname, value)

Set the propertyname to value. If the property is not recognized, SAXNotRecognizedException is raised. If the property or its setting is not supported by the parser, SAXNotSupportedException is raised.

---

Python Library Reference

Previous: 8.12 xml.sax.xmlreader Up: 8.12 xml.sax.xmlreader Next: 8.12.2 IncrementalParser Objects

---

Release 2.5, documentation updated on 19th September, 2006.