En esta página

QDomImplementation Class

La clase QDomImplementation proporciona información sobre las características de la implementación del DOM. Más información...

Encabezado: #include <QDomImplementation>
CMake: find_package(Qt6 REQUIRED COMPONENTS Xml)
target_link_libraries(mytarget PRIVATE Qt6::Xml)
qmake: QT += xml

Nota: Todas las funciones de esta clase son reentrantes, con las siguientes excepciones:

Tipos públicos

enum InvalidDataPolicy { AcceptInvalidChars, DropInvalidChars, ReturnNullNode }

Funciones públicas

QDomImplementation()
QDomImplementation(const QDomImplementation &implementation)
~QDomImplementation()
QDomDocument createDocument(const QString &nsURI, const QString &qName, const QDomDocumentType &doctype)
QDomDocumentType createDocumentType(const QString &qName, const QString &publicId, const QString &systemId)
bool hasFeature(const QString &feature, const QString &version) const
bool isNull()
bool operator!=(const QDomImplementation &other) const
QDomImplementation &operator=(const QDomImplementation &other)
bool operator==(const QDomImplementation &other) const

Miembros públicos estáticos

QDomImplementation::InvalidDataPolicy invalidDataPolicy()
void setInvalidDataPolicy(QDomImplementation::InvalidDataPolicy policy)

Descripción detallada

Esta clase describe las características que admite la implementación DOM. Actualmente se admiten el subconjunto XML de DOM Nivel 1 y DOM Nivel 2 Core.

Normalmente, se utiliza la función QDomDocument::implementation() para obtener el objeto de implementación.

Se puede crear un nuevo tipo de documento con ` createDocumentType()` y un nuevo documento con ` createDocument()`.

Para obtener más información sobre el Modelo de Objetos de Documento (DOM), consulte los niveles 1 y 2 Core. Para una introducción más general a la implementación del DOM, consulte la documentación de QDomDocument.

Las clases QDom presentan algunos problemas de no conformidad con las especificaciones XML que no se pueden solucionar en Qt 4 sin romper la compatibilidad con versiones anteriores. El módulo Qt XML Patterns y las clases QXmlStreamReader y QXmlStreamWriter presentan un mayor grado de conformidad.

Véase también hasFeature().

Documentación sobre tipos de miembros

enum QDomImplementation::InvalidDataPolicy

Esta enumeración especifica qué se debe hacer cuando se invoca una función de fábrica en QDomDocument con datos no válidos.

ConstanteValorDescripción
QDomImplementation::AcceptInvalidChars0Los datos deben almacenarse en el objeto DOM de todos modos. En este caso, es posible que el documento XML resultante no esté bien formado. Este era el valor por defecto y el comportamiento de QDom antes de Qt 6.12.
QDomImplementation::DropInvalidChars1Los caracteres no válidos deben eliminarse de los datos.
QDomImplementation::ReturnNullNode2La función de fábrica debe devolver un nodo nulo. Este es el valor por defecto desde Qt 6.12.

Véase también setInvalidDataPolicy() y invalidDataPolicy().

Documentación de la función miembro

QDomImplementation::QDomImplementation()

Crea un objeto QDomImplementation.

QDomImplementation::QDomImplementation(const QDomImplementation &implementation)

Crea una copia de implementation.

[noexcept] QDomImplementation::~QDomImplementation()

Destruye el objeto y libera sus recursos.

QDomDocument QDomImplementation::createDocument(const QString &nsURI, const QString &qName, const QDomDocumentType &doctype)

Crea un documento DOM con el tipo de documento doctype. Esta función también añade un nodo de elemento raíz con el nombre calificado qName y el URI del espacio de nombres nsURI.

QDomDocumentType QDomImplementation::createDocumentType(const QString &qName, const QString &publicId, const QString &systemId)

Crea un nodo de tipo de documento con el nombre « qName ».

publicId Especifica el identificador público del subconjunto externo. Si se especifica una cadena vacía (QString()) como publicId, esto significa que el tipo de documento no tiene identificador público.

systemId Especifica el identificador de sistema del subconjunto externo. Si se especifica una cadena vacía como systemId, esto significa que el tipo de documento no tiene identificador de sistema.

Dado que no se puede tener un identificador público sin un identificador de sistema, el identificador público se establece en una cadena vacía si no hay identificador de sistema.

El DOM nivel 2 no admite ninguna otra característica de declaración de tipo de documento.

La única forma de utilizar un tipo de documento creado de esta manera es en combinación con la función ` createDocument()` para crear un ` QDomDocument ` con este tipo de documento.

En la especificación DOM, esta es la única forma de crear un documento no nulo. Por razones históricas, Qt también permite crear el documento utilizando el constructor vacío por defecto. El documento resultante es nulo, pero deja de serlo cuando se invoca una función de fábrica, por ejemplo, ` QDomDocument::createElement()`. El documento también deja de ser nulo cuando se invoca setContent().

Véase también createDocument().

bool QDomImplementation::hasFeature(const QString &feature, const QString &version) const

La función devuelve ` true ` si `QDom` implementa el ` version ` solicitado de un ` feature`; en caso contrario, devuelve ` false`.

Las características compatibles actualmente y sus versiones:

CaracterísticaVersión
XML1.0

[static] QDomImplementation::InvalidDataPolicy QDomImplementation::invalidDataPolicy()

Devuelve la política de datos no válidos, que especifica qué se debe hacer cuando se pasan datos no válidos a una función de fábrica en QDomDocument.

Advertencia: Esta función no es reentrante.

Véase también setInvalidDataPolicy() y InvalidDataPolicy.

bool QDomImplementation::isNull()

Devuelve « false » si el objeto se ha creado mediante « QDomDocument::implementation()»; en caso contrario, devuelve « true ».

[static] void QDomImplementation::setInvalidDataPolicy(QDomImplementation::InvalidDataPolicy policy)

Establece la política de datos no válidos, que especifica qué se debe hacer cuando se pasan datos no válidos a una función de fábrica de QDomDocument.

policy se configura para todas las instancias de QDomDocument que ya existen y que se crearán en el futuro.

void XML_snippet_main()
{
QDomDocument doc;
QDomImplementation impl;
// This will create the element, but the resulting XML document will
// be invalid, because '~' is not a valid character in a tag name.
impl.setInvalidDataPolicy(QDomImplementation::AcceptInvalidChars);
QDomElement elt1 = doc.createElement("foo~bar");

// This will create an element with the tag name "foobar".
impl.setInvalidDataPolicy(QDomImplementation::DropInvalidChars);
QDomElement elt2 = doc.createElement("foo~bar");

// This will create a null element.
impl.setInvalidDataPolicy(QDomImplementation::ReturnNullNode);
QDomElement elt3 = doc.createElement("foo~bar");
}

Advertencia: Esta función no es reentrante.

Véase también ` invalidDataPolicy()` y ` InvalidDataPolicy`.

bool QDomImplementation::operator!=(const QDomImplementation &other) const

Devuelve ` true ` si ` other ` y este objeto de implementación DOM se crearon a partir de objetos `QDomDocument` distintos; en caso contrario, devuelve ` false`.

QDomImplementation &QDomImplementation::operator=(const QDomImplementation &other)

Asigna « other » a esta implementación del DOM.

bool QDomImplementation::operator==(const QDomImplementation &other) const

Devuelve ` true ` si ` other ` y este objeto de implementación DOM se crearon a partir del mismo ` QDomDocument`; en caso contrario, devuelve ` false`.

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