QXmlLexicalHandler Class
La clase QXmlLexicalHandler proporciona una interfaz para informar sobre el contenido léxico de los datos XML. Más información...
| Encabezado: | #include <QXmlLexicalHandler> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core5Compat) target_link_libraries(mytarget PRIVATE Qt6::Core5Compat) |
| qmake: | QT += core5compat |
| Heredado por: |
Nota: Todas las funciones de esta clase son reentrantes.
Funciones públicas
| virtual | ~QXmlLexicalHandler() |
| virtual bool | comment(const QString &ch) = 0 |
| virtual bool | endCDATA() = 0 |
| virtual bool | endDTD() = 0 |
| virtual bool | endEntity(const QString &name) = 0 |
| virtual QString | errorString() const = 0 |
| virtual bool | startCDATA() = 0 |
| virtual bool | startDTD(const QString &name, const QString &publicId, const QString &systemId) = 0 |
| virtual bool | startEntity(const QString &name) = 0 |
Descripción detallada
Los eventos del controlador léxico se aplican a todo el documento, no solo al elemento «document», y todos los eventos del controlador léxico aparecen entre los eventos «startDocument» y «endDocument» del controlador de contenido.
Se puede establecer el controlador léxico con ` QXmlReader::setLexicalHandler()`.
El diseño de esta interfaz se basa en la extensión LexicalHandler de SAX2.
La interfaz proporciona las funciones ` startDTD()`, ` endDTD()`, ` startEntity()`, ` endEntity()`, ` startCDATA()`, ` endCDATA()` y ` comment()`.
Véase también QXmlDTDHandler, QXmlDeclHandler, QXmlContentHandler, QXmlEntityResolver y QXmlErrorHandler.
Documentación de funciones de miembro
[virtual noexcept] QXmlLexicalHandler::~QXmlLexicalHandler()
Elimina el gestor léxico.
[pure virtual] bool QXmlLexicalHandler::comment(const QString &ch)
El lector llama a esta función para informar de un comentario XML en cualquier parte del documento. Informa del texto del comentario en ` ch`.
Si esta función devuelve « false », el lector detiene el análisis y notifica un error. El lector utiliza la función errorString() para obtener el mensaje de error.
[pure virtual] bool QXmlLexicalHandler::endCDATA()
El lector llama a esta función para indicar el final de una sección CDATA.
Si esta función devuelve ` false `, el lector detiene el análisis y notifica un error. El lector utiliza la función ` errorString()` para obtener el mensaje de error.
Véanse también « startCDATA()» y « QXmlContentHandler::characters()».
[pure virtual] bool QXmlLexicalHandler::endDTD()
El lector llama a esta función para indicar el final de una declaración de DTD, si la hay.
Si esta función devuelve un valor de tipo « false », el lector detiene el análisis y notifica un error. El lector utiliza la función « errorString()» para obtener el mensaje de error.
Véase también startDTD().
[pure virtual] bool QXmlLexicalHandler::endEntity(const QString &name)
El lector llama a esta función para indicar el final de una entidad denominada « name ».
Por cada llamada a ` startEntity()`, hay una llamada correspondiente a `endEntity()`. Las llamadas a ` startEntity()` y `endEntity()` están correctamente anidadas.
Si esta función devuelve « false », el lector detiene el análisis y notifica un error. El lector utiliza la función « errorString()» para obtener el mensaje de error.
Véanse también startEntity(), QXmlContentHandler::skippedEntity() y QXmlSimpleReader::setFeature().
[pure virtual] QString QXmlLexicalHandler::errorString() const
El lector llama a esta función para obtener una cadena de error si alguna de las funciones de gestión devuelve un valor « false ».
[pure virtual] bool QXmlLexicalHandler::startCDATA()
El lector llama a esta función para indicar el inicio de una sección CDATA. El contenido de la sección CDATA se indica mediante la función QXmlContentHandler::characters(). Esta función está pensada únicamente para indicar el límite.
Si esta función devuelve ` false `, el lector detiene el análisis y notifica un error. El lector utiliza la función ` errorString()` para obtener el mensaje de error.
Véase también endCDATA().
[pure virtual] bool QXmlLexicalHandler::startDTD(const QString &name, const QString &publicId, const QString &systemId)
El lector llama a esta función para notificar el inicio de una declaración DTD, si la hay. Indica el nombre del tipo de documento en name, el identificador público en publicId y el identificador del sistema en systemId.
Si falta el identificador público, publicId se establece como una cadena vacía. Si falta el identificador del sistema, systemId se establece como una cadena vacía. Tenga en cuenta que no es válido en XML tener un identificador público pero no un identificador del sistema; en tales casos se producirá un error de análisis.
Todas las declaraciones indicadas mediante QXmlDTDHandler o QXmlDeclHandler aparecen entre las llamadas a startDTD() y endDTD().
Si esta función devuelve false, el lector detiene el análisis y notifica un error. El lector utiliza la función errorString() para obtener el mensaje de error.
Véase también endDTD().
[pure virtual] bool QXmlLexicalHandler::startEntity(const QString &name)
El lector llama a esta función para notificar el inicio de una entidad denominada « name ».
Tenga en cuenta que, si la entidad es desconocida, el lector la notifica a través de ` QXmlContentHandler::skippedEntity()` y no a través de esta función.
Si esta función devuelve « false », el lector detiene el análisis y notifica un error. El lector utiliza la función « errorString()» para obtener el mensaje de error.
Véanse también endEntity() y QXmlSimpleReader::setFeature().
© 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.