QXmlLexicalHandler Class
La clase QXmlLexicalHandler proporciona una interfaz para informar del contenido léxico de los datos XML. Más...
| Cabecera: | #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 manejador léxico se aplican a todo el documento, no sólo al elemento documento, y todos los eventos del manejador léxico aparecen entre los eventos startDocument y endDocument del manejador de contenido.
Puede definir 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 las funciones miembro
[virtual noexcept] QXmlLexicalHandler::~QXmlLexicalHandler()
Destruye el manejador léxico.
[pure virtual] bool QXmlLexicalHandler::comment(const QString &ch)
El lector llama a esta función para notificar un comentario XML en cualquier parte del documento. Informa del texto del comentario en ch.
Si esta función devuelve false, el lector interrumpe el análisis e informa de 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 informar del final de una sección CDATA.
Si esta función devuelve false, el lector interrumpe el análisis e informa de un error. El lector utiliza la función errorString() para obtener el mensaje de error.
Véase también startCDATA() y QXmlContentHandler::characters().
[pure virtual] bool QXmlLexicalHandler::endDTD()
El lector llama a esta función para informar del final de una declaración DTD, si existe.
Si esta función devuelve false, el lector deja de analizar e informa de 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 informar del final de una entidad llamada 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 interrumpe el análisis sintáctico e informa de un error. El lector utiliza la función errorString() para obtener el mensaje de error.
Véase 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 del manejador devuelve false.
[pure virtual] bool QXmlLexicalHandler::startCDATA()
El lector llama a esta función para informar del inicio de una sección CDATA. El contenido de la sección CDATA se notifica a través de la función QXmlContentHandler::characters(). Esta función sólo informa del límite.
Si esta función devuelve false, el lector interrumpe el análisis e informa de 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 informar del inicio de una declaración DTD, si existe. Informa del nombre del tipo de documento en name, del identificador público en publicId y del identificador del sistema en systemId.
Si falta el identificador público, publicId se establece en una cadena vacía. Si falta el identificador del sistema, systemId se convierte en una cadena vacía. Tenga en cuenta que no es un XML válido tener un identificador público pero no un identificador del sistema; en estos casos se producirá un error de análisis.
Todas las declaraciones notificadas a través de QXmlDTDHandler o QXmlDeclHandler aparecen entre las llamadas startDTD() y endDTD().
Si esta función devuelve false, el lector interrumpe el análisis sintáctico e informa de 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 informar del inicio de una entidad llamada name.
Tenga en cuenta que si la entidad es desconocida, el lector informa de ella a través de QXmlContentHandler::skippedEntity() y no a través de esta función.
Si esta función devuelve false, el lector interrumpe el análisis sintáctico e informa de un error. El lector utiliza la función errorString() para obtener el mensaje de error.
Véase 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.
