QXmlDTDHandler Class

The QXmlDTDHandler class provides an interface to report DTD content of XML data. More...

Header: #include <QXmlDTDHandler>
qmake: QT += xml
Inherited By:

QXmlDefaultHandler

This class is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.

Note: All functions in this class are reentrant.

Public Functions

virtual ~QXmlDTDHandler()
virtual QString errorString() const = 0
virtual bool notationDecl(const QString &name, const QString &publicId, const QString &systemId) = 0
virtual bool unparsedEntityDecl(const QString &name, const QString &publicId, const QString &systemId, const QString &notationName) = 0

Detailed Description

If an application needs information about notations and unparsed entities, it can implement this interface and register an instance with QXmlReader::setDTDHandler().

Note that this interface includes only those DTD events that the XML recommendation requires processors to report, i.e. notation and unparsed entity declarations using notationDecl() and unparsedEntityDecl() respectively.

See also QXmlDeclHandler, QXmlContentHandler, QXmlEntityResolver, QXmlErrorHandler, QXmlLexicalHandler, and Introduction to SAX2.

Member Function Documentation

[virtual] QXmlDTDHandler::~QXmlDTDHandler()

Destroys the DTD handler.

[pure virtual] QString QXmlDTDHandler::errorString() const

The reader calls this function to get an error string if any of the handler functions returns false.

[pure virtual] bool QXmlDTDHandler::notationDecl(const QString &name, const QString &publicId, const QString &systemId)

The reader calls this function when it has parsed a notation declaration.

The argument name is the notation name, publicId is the notation's public identifier and systemId is the notation's system identifier.

If this function returns false the reader stops parsing and reports an error. The reader uses the function errorString() to get the error message.

[pure virtual] bool QXmlDTDHandler::unparsedEntityDecl(const QString &name, const QString &publicId, const QString &systemId, const QString &notationName)

The reader calls this function when it finds an unparsed entity declaration.

The argument name is the unparsed entity's name, publicId is the entity's public identifier, systemId is the entity's system identifier and notationName is the name of the associated notation.

If this function returns false the reader stops parsing and reports an error. The reader uses the function errorString() to get the error message.