QXmlErrorHandler Class

Die Klasse QXmlErrorHandler bietet eine Schnittstelle zur Meldung von Fehlern in XML-Daten. Mehr...

Kopfzeile: #include <QXmlErrorHandler>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core5Compat)
target_link_libraries(mytarget PRIVATE Qt6::Core5Compat)
qmake: QT += core5compat
Vererbt von:

QXmlDefaultHandler

Hinweis: Alle Funktionen in dieser Klasse sind reentrant.

Öffentliche Funktionen

virtual ~QXmlErrorHandler()
virtual bool error(const QXmlParseException &exception) = 0
virtual QString errorString() const = 0
virtual bool fatalError(const QXmlParseException &exception) = 0
virtual bool warning(const QXmlParseException &exception) = 0

Detaillierte Beschreibung

Wenn Sie möchten, dass Ihre Anwendung Fehler an den Benutzer meldet oder eine benutzerdefinierte Fehlerbehandlung durchführt, sollten Sie diese Klasse unterklassifizieren.

Sie können den Fehlerhandler mit QXmlReader::setErrorHandler() einstellen.

Fehler können mit warning(), error() und fatalError() gemeldet werden, wobei der Fehlertext mit errorString() gemeldet wird.

Siehe auch QXmlDTDHandler, QXmlDeclHandler, QXmlContentHandler, QXmlEntityResolver, und QXmlLexicalHandler.

Dokumentation der Mitgliedsfunktionen

[virtual noexcept] QXmlErrorHandler::~QXmlErrorHandler()

Zerstört den Error-Handler.

[pure virtual] bool QXmlErrorHandler::error(const QXmlParseException &exception)

Ein Leser kann diese Funktion verwenden, um einen behebbaren Fehler zu melden. Ein behebbarer Fehler entspricht der Definition von "error" in Abschnitt 1.2 der XML 1.0-Spezifikation. Die Einzelheiten des Fehlers werden in exception gespeichert.

Der Reader muss nach dem Aufruf dieser Funktion weiterhin normale Parsing-Ereignisse liefern.

Wenn diese Funktion false zurückgibt, bricht der Reader das Parsen ab und meldet einen Fehler. Der Reader verwendet die Funktion errorString(), um die Fehlermeldung zu erhalten.

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

Der Leser ruft diese Funktion auf, um einen Fehlerstring zu erhalten, wenn eine der Handler-Funktionen false zurückgibt.

[pure virtual] bool QXmlErrorHandler::fatalError(const QXmlParseException &exception)

Ein Leser muss diese Funktion verwenden, um einen nicht behebbaren Fehler zu melden. Die Einzelheiten des Fehlers werden in exception gespeichert.

Wenn diese Funktion true zurückgibt, kann der Leser versuchen, mit dem Parsen fortzufahren und weitere Fehler zu melden, aber es werden keine regelmäßigen Parsing-Ereignisse gemeldet.

[pure virtual] bool QXmlErrorHandler::warning(const QXmlParseException &exception)

Ein Leser kann diese Funktion verwenden, um eine Warnung zu melden. Warnungen sind Bedingungen, die keine Fehler oder schwerwiegenden Fehler im Sinne der XML 1.0-Spezifikation sind. Die Einzelheiten der Warnung werden in exception gespeichert.

Wenn diese Funktion false zurückgibt, bricht der Reader das Parsen ab und meldet einen Fehler. Der Reader verwendet die Funktion errorString(), um die Fehlermeldung zu erhalten.

© 2025 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.