QXmlEntityResolver Class
Die Klasse QXmlEntityResolver bietet eine Schnittstelle zum Auflösen von externen Entitäten in XML-Daten. Mehr...
| Kopfzeile: | #include <QXmlEntityResolver> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core5Compat)target_link_libraries(mytarget PRIVATE Qt6::Core5Compat) |
| qmake: | QT += core5compat |
| Vererbt von: |
Hinweis: Alle Funktionen in dieser Klasse sind reentrant.
Öffentliche Funktionen
| virtual | ~QXmlEntityResolver() |
| virtual QString | errorString() const = 0 |
| virtual bool | resolveEntity(const QString &publicId, const QString &systemId, QXmlInputSource *&ret) = 0 |
Detaillierte Beschreibung
Wenn eine Anwendung eine benutzerdefinierte Behandlung für externe Entitäten implementieren muss, muss sie diese Schnittstelle implementieren, d. h. resolveEntity(), und sie mit QXmlReader::setEntityResolver() registrieren.
Siehe auch QXmlDTDHandler, QXmlDeclHandler, QXmlContentHandler, QXmlErrorHandler, und QXmlLexicalHandler.
Dokumentation der Mitgliedsfunktionen
[virtual noexcept] QXmlEntityResolver::~QXmlEntityResolver()
Zerstört den Entitätsauflöser.
[pure virtual] QString QXmlEntityResolver::errorString() const
Der Leser ruft diese Funktion auf, um einen Fehlerstring zu erhalten, wenn eine der Handler-Funktionen false zurückgibt.
[pure virtual] bool QXmlEntityResolver::resolveEntity(const QString &publicId, const QString &systemId, QXmlInputSource *&ret)
Der Reader ruft diese Funktion auf, bevor er irgendeine externe Entität öffnet, mit Ausnahme der Top-Level-Dokumentenentität. Die Anwendung kann den Reader auffordern, die Entität selbst aufzulösen (ret ist 0) oder eine völlig andere Eingabequelle zu verwenden (ret zeigt auf die Eingabequelle).
Der Reader löscht die Eingabequelle ret, wenn er sie nicht mehr benötigt, daher sollten Sie sie auf dem Heap mit new zuweisen.
Das Argument publicId ist der öffentliche Bezeichner der externen Einheit, systemId ist der Systembezeichner der externen Einheit und ret ist der Rückgabewert dieser Funktion. Wenn ret gleich 0 ist, sollte der Leser die Entität selbst auflösen, wenn sie ungleich Null ist, muss sie auf eine Eingabequelle zeigen, die der Leser stattdessen verwendet.
Wenn diese Funktion false zurückgibt, bricht der Leser das Parsen ab und meldet einen Fehler. Der Leser 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.
