Sur cette page

QXmlEntityResolver Class

La classe QXmlEntityResolver fournit une interface pour résoudre les entités externes contenues dans les données XML. Plus d'informations...

En-tête : #include <QXmlEntityResolver>
CMake : find_package(Qt6 REQUIRED COMPONENTS Core5Compat)
target_link_libraries(mytarget PRIVATE Qt6::Core5Compat)
qmake : QT += core5compat
Inherited By :

QXmlDefaultHandler

Note : Toutes les fonctions de cette classe sont réentrantes.

Fonctions publiques

virtual ~QXmlEntityResolver()
virtual QString errorString() const = 0
virtual bool resolveEntity(const QString &publicId, const QString &systemId, QXmlInputSource *&ret) = 0

Description détaillée

Si une application doit mettre en œuvre une gestion personnalisée pour des entités externes, elle doit mettre en œuvre cette interface, c'est-à-dire resolveEntity(), et l'enregistrer auprès de QXmlReader::setEntityResolver().

Voir également QXmlDTDHandler, QXmlDeclHandler, QXmlContentHandler, QXmlErrorHandler, et QXmlLexicalHandler.

Documentation des fonctions membres

[virtual noexcept] QXmlEntityResolver::~QXmlEntityResolver()

Détruit le résolveur d'entités.

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

Le lecteur appelle cette fonction pour obtenir une chaîne d'erreur si l'une des fonctions de traitement renvoie false.

[pure virtual] bool QXmlEntityResolver::resolveEntity(const QString &publicId, const QString &systemId, QXmlInputSource *&ret)

Le lecteur appelle cette fonction avant d'ouvrir toute entité externe, à l'exception de l'entité du document de premier niveau. L'application peut demander au lecteur de résoudre lui-même l'entité (ret vaut 0) ou d'utiliser une source d'entrée entièrement différente (ret pointe vers la source d'entrée).

Le lecteur supprime la source d'entrée ret lorsqu'il n'en a plus besoin, vous devez donc l'allouer sur le tas avec new.

L'argument publicId est l'identifiant public de l'entité externe, systemId est l'identifiant système de l'entité externe et ret est la valeur de retour de cette fonction. Si ret est égal à 0, le lecteur doit résoudre l'entité lui-même ; s'il est différent de zéro, il doit pointer vers une source d'entrée que le lecteur utilise à la place.

Si cette fonction renvoie false, le lecteur arrête l'analyse et signale une erreur. Le lecteur utilise la fonction errorString() pour obtenir le message d'erreur.

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