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.

© 2020 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.