En esta página

QDomNode Class

La clase QDomNode es la clase base de todos los nodos de un árbol DOM. Más información...

Encabezado: #include <QDomNode>
CMake: find_package(Qt6 REQUIRED COMPONENTS Xml)
target_link_libraries(mytarget PRIVATE Qt6::Xml)
qmake: QT += xml
Heredado por:
10 tipos

QDomAttr, QDomCharacterData, QDomDocument, QDomDocumentFragment, QDomDocumentType, QDomElement, QDomEntity, QDomEntityReference, QDomNotation, y QDomProcessingInstruction

Nota: Todas las funciones de esta clase son reentrantes.

Tipos públicos

enum EncodingPolicy { EncodingFromDocument, EncodingFromTextStream }
enum NodeType { ElementNode, AttributeNode, TextNode, CDATASectionNode, EntityReferenceNode, …, CharacterDataNode }

Funciones públicas

QDomNode()
QDomNode(const QDomNode &node)
~QDomNode()
QDomNode appendChild(const QDomNode &newChild)
QDomNamedNodeMap attributes() const
QDomNodeList childNodes() const
void clear()
QDomNode cloneNode(bool deep = true) const
int columnNumber() const
QDomNode firstChild() const
QDomElement firstChildElement(const QString &tagName = QString(), const QString &namespaceURI = QString()) const
bool hasAttributes() const
bool hasChildNodes() const
QDomNode insertAfter(const QDomNode &newChild, const QDomNode &refChild)
QDomNode insertBefore(const QDomNode &newChild, const QDomNode &refChild)
bool isAttr() const
bool isCDATASection() const
bool isCharacterData() const
bool isComment() const
bool isDocument() const
bool isDocumentFragment() const
bool isDocumentType() const
bool isElement() const
bool isEntity() const
bool isEntityReference() const
bool isNotation() const
bool isNull() const
bool isProcessingInstruction() const
bool isSupported(const QString &feature, const QString &version) const
bool isText() const
QDomNode lastChild() const
QDomElement lastChildElement(const QString &tagName = QString(), const QString &namespaceURI = QString()) const
int lineNumber() const
QString localName() const
QDomNode namedItem(const QString &name) const
QString namespaceURI() const
QDomNode nextSibling() const
QDomElement nextSiblingElement(const QString &tagName = QString(), const QString &namespaceURI = QString()) const
QString nodeName() const
QDomNode::NodeType nodeType() const
QString nodeValue() const
void normalize()
QDomDocument ownerDocument() const
QDomNode parentNode() const
QString prefix() const
QDomNode previousSibling() const
QDomElement previousSiblingElement(const QString &tagName = QString(), const QString &namespaceURI = QString()) const
QDomNode removeChild(const QDomNode &oldChild)
QDomNode replaceChild(const QDomNode &newChild, const QDomNode &oldChild)
void save(QTextStream &stream, int indent, QDomNode::EncodingPolicy encodingPolicy = QDomNode::EncodingFromDocument) const
void setNodeValue(const QString &value)
void setPrefix(const QString &pre)
QDomAttr toAttr() const
QDomCDATASection toCDATASection() const
QDomCharacterData toCharacterData() const
QDomComment toComment() const
QDomDocument toDocument() const
QDomDocumentFragment toDocumentFragment() const
QDomDocumentType toDocumentType() const
QDomElement toElement() const
QDomEntity toEntity() const
QDomEntityReference toEntityReference() const
QDomNotation toNotation() const
QDomProcessingInstruction toProcessingInstruction() const
QDomText toText() const
bool operator!=(const QDomNode &other) const
QDomNode &operator=(const QDomNode &other)
bool operator==(const QDomNode &other) const
QTextStream &operator<<(QTextStream &str, const QDomNode &node)

Descripción detallada

Muchas funciones del DOM devuelven un QDomNode.

Puedes averiguar el tipo de un nodo utilizando isAttr(), isCDATASection(), isDocumentFragment(), isDocument(), isDocumentType(), isElement(), isEntityReference(), isText(), isEntity(), isNotation(), isProcessingInstruction(), isCharacterData() y isComment().

Un QDomNode se puede convertir en una de sus subclases utilizando toAttr(), toCDATASection(), toDocumentFragment(), toDocument(), toDocumentType(), toElement(), toEntityReference(), toText(), toEntity(), toNotation(), toProcessingInstruction(), toCharacterData() o toComment(). Se puede convertir un nodo en un nodo nulo con clear().

Las copias de la clase `QDomNode` comparten sus datos mediante el uso explícito de «sharing». Esto significa que modificar un nodo cambiará todas las copias. Esto resulta especialmente útil en combinación con funciones que devuelven un `QDomNode`, por ejemplo, ` firstChild()`. Se puede realizar una copia independiente (profunda) del nodo con ` cloneNode()`.

Un QDomNode puede ser nulo, al igual que nullptr. Al crear una copia de un nodo nulo, se obtiene otro nodo nulo. No es posible modificar un nodo nulo, pero sí es posible asignarle otro nodo, que puede no ser nulo. En este caso, la copia del nodo nulo seguirá siendo nula. Se puede comprobar si un QDomNode es nulo llamando a isNull(). El constructor vacío de un QDomNode (o de cualquiera de sus clases derivadas) crea un nodo nulo.

Los nodos se insertan con ` insertBefore()`, ` insertAfter()` o ` appendChild()`. Se puede sustituir un nodo por otro utilizando ` replaceChild()` y eliminar un nodo con ` removeChild()`.

Para recorrer los nodos, utiliza firstChild() para obtener el primer hijo de un nodo (si lo hay) y nextSibling() para recorrerlo. QDomNode también proporciona lastChild(), previousSibling() y parentNode(). Para encontrar el primer nodo hijo con un nombre de nodo concreto, utiliza namedItem().

Para saber si un nodo tiene hijos, utiliza hasChildNodes() y, para obtener una lista de todos los hijos de un nodo, utiliza childNodes().

El nombre y el valor del nodo (cuyo significado varía en función de su tipo) se obtienen mediante nodeName() y nodeValue(), respectivamente. El tipo del nodo se obtiene mediante nodeType(). El valor del nodo se puede establecer con setNodeValue().

El documento al que pertenece el nodo se devuelve mediante ownerDocument().

Los nodos adyacentes de QDomText pueden fusionarse en un único nodo mediante normalize().

QDomElement Los nodos tienen atributos que se pueden recuperar mediante ` attributes()`.

QDomElement Además, los nodos ` QDomAttr ` pueden tener espacios de nombres que se pueden recuperar con ` namespaceURI()`. Su nombre local se recupera con ` localName()`, y su prefijo con ` prefix()`. El prefijo se puede establecer con ` setPrefix()`.

Se puede escribir la representación XML del nodo en un flujo de texto mediante ` save()`.

El siguiente ejemplo busca el primer elemento de un documento XML e imprime los nombres de todos los elementos que son sus hijos directos.

QDomDocument d;
QString someXML;

d.setContent(someXML);
QDomNode n = d.firstChild();
while (!n.isNull()) {
    if (n.isElement()) {
        QDomElement e = n.toElement();
        cout << "Element name: " << qPrintable(e.tagName()) << '\n';
        break;
    }
    n = n.nextSibling();
}

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.

Documentación sobre los tipos de miembros

enum QDomNode::EncodingPolicy

Esta enumeración especifica cómo determina ` QDomNode::save()` qué codificación utilizar al serializar.

ConstanteValorDescripción
QDomNode::EncodingFromDocument1La codificación se obtiene del documento.
QDomNode::EncodingFromTextStream2La codificación se obtiene de QTextStream.

Véase también QDomNode::save().

enum QDomNode::NodeType

Esta enumeración define el tipo del nodo:

ConstanteValorDescripción
QDomNode::ElementNode1 
QDomNode::AttributeNode2 
QDomNode::TextNode3 
QDomNode::CDATASectionNode4 
QDomNode::EntityReferenceNode5 
QDomNode::EntityNode6 
QDomNode::ProcessingInstructionNode7 
QDomNode::CommentNode8 
QDomNode::DocumentNode9 
QDomNode::DocumentTypeNode10 
QDomNode::DocumentFragmentNode11 
QDomNode::NotationNode12 
QDomNode::BaseNode21Un objeto de tipo « QDomNode », es decir, que no sea una subclase de « QDomNode ».
QDomNode::CharacterDataNode22 

Documentación de las funciones de miembro

QDomNode::QDomNode()

Crea un nodo « null ».

QDomNode::QDomNode(const QDomNode &node)

Crea una copia de node.

Los datos de la copia son compartidos (copia superficial): al modificar un nodo, también se modificará el otro. Si deseas realizar una copia profunda, utiliza cloneNode().

[noexcept] QDomNode::~QDomNode()

Destruye el objeto y libera sus recursos.

QDomNode QDomNode::appendChild(const QDomNode &newChild)

Añade newChild como último hijo del nodo.

Si newChild es hijo de otro nodo, se le asigna como padre este nodo. Si newChild es hijo de este nodo, se cambia su posición en la lista de hijos.

Si newChild es un QDomDocumentFragment, los hijos del fragmento se eliminan de este y se añaden al final.

Si newChild es un QDomElement y este nodo es un QDomDocument que ya tiene un nodo de elemento como hijo, newChild no se añade como hijo y se devuelve un nodo nulo.

Devuelve una nueva referencia a newChild si la operación se realiza correctamente, o un null node si falla.

La llamada a esta función sobre un nodo nulo (creado, por ejemplo, con el constructor por defecto) no realiza ninguna acción y devuelve un null node.

La especificación DOM no permite insertar nodos de atributo, pero por razones históricas, QDom los acepta de todos modos.

Véase también insertBefore(), insertAfter(), replaceChild() y removeChild().

QDomNamedNodeMap QDomNode::attributes() const

Devuelve un mapa de nodos con nombre que contiene todos los atributos. Los atributos solo se proporcionan para los « QDomElement».

Al modificar los atributos del mapa, también se modificarán los atributos de este QDomNode.

QDomNodeList QDomNode::childNodes() const

Devuelve una lista de todos los nodos hijos directos.

Lo más habitual es llamar a esta función sobre un objeto ` QDomElement `.

Por ejemplo, si el documento XML tiene este aspecto:

<body>
<h1>Heading</h1>
<p>Hello <b>you</b></p>
</body>

entonces la lista de nodos hijos del elemento «body» contendrá el nodo creado por la etiqueta &lt;h1&gt; y el nodo creado por la etiqueta &lt;p&gt;.

Los nodos de la lista no se copian; por lo tanto, al modificar los nodos de la lista también se modificarán los hijos de este nodo.

Véanse también firstChild() y lastChild().

void QDomNode::clear()

Convierte el nodo en un nodo nulo; si antes no era un nodo nulo, se eliminan su tipo y su contenido.

Véase también isNull().

QDomNode QDomNode::cloneNode(bool deep = true) const

Crea una copia profunda (no superficial) del ` QDomNode`.

Si deep es verdadero, la clonación se realiza de forma recursiva, lo que significa que también se realiza una copia profunda de todos los nodos hijos del nodo. Si deep es falso, solo se copia el propio nodo y la copia no tendrá nodos hijos.

int QDomNode::columnNumber() const

Para los nodos creados mediante QDomDocument::setContent(), esta función devuelve el número de columna del documento XML en el que se analizó el nodo. En caso contrario, devuelve -1.

Véanse también lineNumber() y QDomDocument::setContent().

QDomNode QDomNode::firstChild() const

Devuelve el primer nodo secundario del nodo. Si no hay ningún nodo secundario, se devuelve un objeto ` null node `. Al modificar el nodo devuelto, también se modificará el nodo en el árbol del documento.

Véase también lastChild() y childNodes().

QDomElement QDomNode::firstChildElement(const QString &tagName = QString(), const QString &namespaceURI = QString()) const

Devuelve el primer elemento hijo con el nombre de etiqueta tagName y el URI de espacio de nombres namespaceURI. Si tagName está vacío, devuelve el primer elemento hijo con namespaceURI, y si namespaceURI está vacío, devuelve el primer elemento hijo con tagName. Si ambos parámetros están vacíos, devuelve el primer elemento hijo. Devuelve un elemento nulo si no existe dicho elemento hijo.

Véase también lastChildElement(), previousSiblingElement() y nextSiblingElement().

bool QDomNode::hasAttributes() const

Devuelve ` true ` si el nodo tiene atributos; en caso contrario, devuelve ` false`.

Véase también attributes().

bool QDomNode::hasChildNodes() const

Devuelve ` true ` si el nodo tiene uno o más hijos; en caso contrario, devuelve ` false`.

QDomNode QDomNode::insertAfter(const QDomNode &newChild, const QDomNode &refChild)

Inserta el nodo newChild después del nodo hijo refChild. refChild debe ser un hijo directo de este nodo. Si refChild es null, entonces newChild se añade como último hijo de este nodo.

Si newChild es un hijo de otro nodo, se le asigna como padre este nodo. Si newChild es un hijo de este nodo, entonces se cambia su posición en la lista de hijos.

Si newChild es un QDomDocumentFragment, los hijos del fragmento se eliminan del fragmento y se insertan después de refChild.

Devuelve una nueva referencia a newChild si la operación se realiza correctamente, o un null node si falla.

La especificación DOM no permite insertar nodos de atributo, pero, por razones históricas, QDom los acepta de todos modos.

Véanse también « insertBefore()», « replaceChild()», « removeChild()» y « appendChild()».

QDomNode QDomNode::insertBefore(const QDomNode &newChild, const QDomNode &refChild)

Inserta el nodo newChild antes del nodo hijo refChild. refChild debe ser un hijo directo de este nodo. Si refChild es null, entonces newChild se inserta como el primer hijo del nodo.

Si newChild es un hijo de otro nodo, se le asigna como padre a este nodo. Si newChild es un hijo de este nodo, entonces se cambia su posición en la lista de hijos.

Si newChild es un QDomDocumentFragment, los hijos del fragmento se eliminan de este y se insertan antes de refChild.

Devuelve una nueva referencia a newChild en caso de éxito o un null node en caso de fallo.

La especificación DOM no permite insertar nodos de atributo, pero, por razones históricas, QDom los acepta de todos modos.

Véase también insertAfter(), replaceChild(), removeChild() y appendChild().

bool QDomNode::isAttr() const

Devuelve ` true ` si el nodo es un atributo; en caso contrario, devuelve ` false`.

Si esta función devuelve true, ello no implica que este objeto sea un QDomAttribute; puede obtener el QDomAttribute mediante toAttribute().

Véase también toAttr().

bool QDomNode::isCDATASection() const

Devuelve ` true ` si el nodo es una sección CDATA; en caso contrario, devuelve `false`.

Si esta función devuelve ` true`, ello no implica que este objeto sea un ` QDomCDATASection`; puede obtener el ` QDomCDATASection ` con ` toCDATASection()` ().

Véase también toCDATASection().

bool QDomNode::isCharacterData() const

Devuelve « true » si el nodo es un nodo de datos de carácter; en caso contrario, devuelve « false ».

Si esta función devuelve ` true`, ello no implica que este objeto sea un ` QDomCharacterData`; puede obtener el ` QDomCharacterData ` con ` toCharacterData()`.

Véase también toCharacterData().

bool QDomNode::isComment() const

Devuelve ` true ` si el nodo es un comentario; en caso contrario, devuelve ` false`.

Si esta función devuelve true, ello no implica que este objeto sea un QDomComment; puede obtener el QDomComment con toComment().

Véase también toComment().

bool QDomNode::isDocument() const

Devuelve ` true ` si el nodo es un documento; en caso contrario, devuelve ` false`.

Si esta función devuelve true, ello no implica que este objeto sea un QDomDocument; puedes obtener el QDomDocument con toDocument().

Véase también toDocument().

bool QDomNode::isDocumentFragment() const

Devuelve ` true ` si el nodo es un fragmento de documento; en caso contrario, devuelve `false`.

Si esta función devuelve « true », ello no implica que este objeto sea un « QDomDocumentFragment »; puedes obtener el « QDomDocumentFragment » con « toDocumentFragment()».

Véase también toDocumentFragment().

bool QDomNode::isDocumentType() const

Devuelve ` true ` si el nodo es de tipo documento; en caso contrario, devuelve `false`.

Si esta función devuelve « true », ello no implica que este objeto sea un « QDomDocumentType »; puede obtener el « QDomDocumentType » con « toDocumentType()».

Véase también toDocumentType().

bool QDomNode::isElement() const

Devuelve ` true ` si el nodo es un elemento; en caso contrario, devuelve ` false`.

Si esta función devuelve « true », ello no implica que este objeto sea un « QDomElement »; puede obtener el « QDomElement » con « toElement()».

Véase también toElement().

bool QDomNode::isEntity() const

Devuelve ` true ` si el nodo es una entidad; en caso contrario, devuelve ` false`.

Si esta función devuelve true, ello no implica que este objeto sea un QDomEntity; puede obtener el QDomEntity con toEntity().

Véase también toEntity().

bool QDomNode::isEntityReference() const

Devuelve « true » si el nodo es una referencia a una entidad; en caso contrario, devuelve «false».

Si esta función devuelve « true », ello no implica que este objeto sea un « QDomEntityReference »; puede obtener el « QDomEntityReference » con « toEntityReference()».

Véase también toEntityReference().

bool QDomNode::isNotation() const

Devuelve « true » si el nodo es una notación; en caso contrario, devuelve « false ».

Si esta función devuelve true, ello no implica que este objeto sea un QDomNotation; puede obtener el QDomNotation mediante toNotation().

Véase también toNotation().

bool QDomNode::isNull() const

Devuelve ` true ` si este nodo es nulo (es decir, si no tiene tipo ni contenido); en caso contrario, devuelve ` false`.

bool QDomNode::isProcessingInstruction() const

Devuelve ` true ` si el nodo es una instrucción de procesamiento; en caso contrario, devuelve ` false`.

Si esta función devuelve « true », ello no implica que este objeto sea un « QDomProcessingInstruction »; puede obtener el «QProcessingInstruction» con « toProcessingInstruction()».

Véase también ` toProcessingInstruction()`.

bool QDomNode::isSupported(const QString &feature, const QString &version) const

Devuelve « true » si la implementación DOM implementa la característica « feature » y este nodo admite dicha característica en la versión « version »; en caso contrario, devuelve « false ».

Véase también QDomImplementation::hasFeature().

bool QDomNode::isText() const

Devuelve ` true ` si el nodo es un nodo de texto; en caso contrario, devuelve ` false`.

Si esta función devuelve true, esto no implica que este objeto sea un QDomText; puedes obtener el QDomText con toText().

Véase también toText().

QDomNode QDomNode::lastChild() const

Devuelve el último nodo hijo del nodo. Si no hay ningún nodo hijo, se devuelve un objeto ` null node `. Al modificar el nodo devuelto, también se modificará el nodo en el árbol del documento.

Véanse también firstChild() y childNodes().

QDomElement QDomNode::lastChildElement(const QString &tagName = QString(), const QString &namespaceURI = QString()) const

Devuelve el último elemento hijo con el nombre de etiqueta tagName y el URI de espacio de nombres namespaceURI. Si tagName está vacío, devuelve el último elemento hijo con namespaceURI, y si namespaceURI está vacío, devuelve el último elemento hijo con tagName. Si ambos parámetros están vacíos, devuelve el último elemento hijo. Devuelve un elemento nulo si no existe dicho elemento hijo.

Véase también firstChildElement(), previousSiblingElement() y nextSiblingElement().

int QDomNode::lineNumber() const

Para los nodos creados mediante ` QDomDocument::setContent()` (), esta función devuelve el número de línea del documento XML en el que se analizó el nodo. En caso contrario, devuelve -1.

Véanse también columnNumber() y QDomDocument::setContent().

QString QDomNode::localName() const

Si el nodo utiliza espacios de nombres, esta función devuelve el nombre local del nodo; en caso contrario, devuelve una cadena vacía.

Solo los nodos de tipo ElementNode o AttributeNode pueden tener espacios de nombres. El espacio de nombres debe haberse especificado en el momento de la creación; no es posible añadirlo posteriormente.

Véanse también prefix(), namespaceURI(), QDomDocument::createElementNS() y QDomDocument::createAttributeNS().

QDomNode QDomNode::namedItem(const QString &name) const

Devuelve el primer nodo hijo directo para el que ` nodeName()` sea igual a ` name`.

Si no existe dicho nodo hijo directo, se devuelve un null node.

Véase también nodeName().

QString QDomNode::namespaceURI() const

Devuelve el URI del espacio de nombres de este nodo o una cadena vacía si el nodo no tiene URI de espacio de nombres.

Solo los nodos de tipo ElementNode o AttributeNode pueden tener espacios de nombres. Se debe especificar un URI de espacio de nombres en el momento de la creación y no se puede modificar posteriormente.

Véanse también prefix(), localName(), QDomDocument::createElementNS() y QDomDocument::createAttributeNS().

QDomNode QDomNode::nextSibling() const

Devuelve el siguiente nodo hermano en el árbol del documento. Al modificar el nodo devuelto, también se modificará el nodo en el árbol del documento.

Si tienes un XML como este:

<h1>Heading</h1>
<p>The text...</p>
<h2>Next heading</h2>

y este QDomNode representa la etiqueta <p>, nextSibling() devolverá el nodo que representa la etiqueta <h2>.

Véase también previousSibling().

QDomElement QDomNode::nextSiblingElement(const QString &tagName = QString(), const QString &namespaceURI = QString()) const

Devuelve el siguiente elemento hermano con el nombre de etiqueta tagName y el URI del espacio de nombres namespaceURI. Si tagName está vacío, devuelve el siguiente elemento hermano con namespaceURI, y si namespaceURI está vacío, devuelve el siguiente elemento hijo hermano con tagName. Si ambos parámetros están vacíos, devuelve el siguiente elemento hermano. Devuelve un elemento nulo si no existe dicho elemento hermano.

Véase también firstChildElement(), previousSiblingElement() y lastChildElement().

QString QDomNode::nodeName() const

Devuelve el nombre del nodo.

El significado del nombre depende de la subclase:

NombreSignificado
QDomAttrEl nombre del atributo
QDomCDATASectionLa cadena «#cdata-section»
QDomCommentLa cadena «#comment»
QDomDocumentLa cadena «#document»
QDomDocumentFragmentLa cadena «#document-fragment»
QDomDocumentTypeEl nombre del tipo de documento
QDomElementEl nombre de la etiqueta
QDomEntityEl nombre de la entidad
QDomEntityReferenceEl nombre de la entidad a la que se hace referencia
QDomNotationEl nombre de la notación
QDomProcessingInstructionEl destino de la instrucción de procesamiento
QDomTextLa cadena «#text»

Nota: Esta función no tiene en cuenta la presencia de espacios de nombres al procesar los nombres de los nodos de elementos y atributos. Como resultado, el nombre devuelto puede contener cualquier prefijo de espacio de nombres que pueda estar presente. Para obtener el nombre del nodo de un elemento o atributo, utiliza localName(); para obtener el prefijo del espacio de nombres, utiliza namespaceURI().

Véase también nodeValue().

QDomNode::NodeType QDomNode::nodeType() const

Devuelve el tipo del nodo.

Véase también toAttr(), toCDATASection(), toDocumentFragment(), toDocument(), toDocumentType(), toElement(), toEntityReference(), toText(), toEntity(), toNotation(), toProcessingInstruction(), toCharacterData() y toComment().

QString QDomNode::nodeValue() const

Devuelve el valor del nodo.

El significado del valor depende de la subclase:

NombreSignificado
QDomAttrEl valor del atributo
QDomCDATASectionEl contenido de la sección CDATA
QDomCommentEl comentario
QDomProcessingInstructionLos datos de la instrucción de procesamiento
QDomTextEl texto

El resto de subclases no tienen un valor de nodo y devolverán una cadena vacía.

Véase también setNodeValue() y nodeName().

void QDomNode::normalize()

Al llamar a la función `normalize()` sobre un elemento, todos sus hijos se convierten a un formato estándar. Esto significa que los objetos ` QDomText ` adyacentes se fusionarán en un único objeto de texto (los nodos `QDomCDATASection ` no se fusionan).

QDomDocument QDomNode::ownerDocument() const

Devuelve el documento al que pertenece este nodo.

QDomNode QDomNode::parentNode() const

Devuelve el nodo padre. Si este nodo no tiene padre, se devuelve un nodo nulo (es decir, un nodo para el que isNull() devuelve true).

QString QDomNode::prefix() const

Devuelve el prefijo del espacio de nombres del nodo o una cadena vacía si el nodo no tiene prefijo de espacio de nombres.

Solo los nodos de tipo ElementNode o AttributeNode pueden tener espacios de nombres. El prefijo del espacio de nombres debe especificarse en el momento de la creación. Si un nodo se ha creado con un prefijo de espacio de nombres, se puede cambiar posteriormente con setPrefix().

Si se crea un elemento o un atributo con QDomDocument::createElement() o QDomDocument::createAttribute(), el prefijo será una cadena vacía. Si, en cambio, se utiliza QDomDocument::createElementNS() o QDomDocument::createAttributeNS(), el prefijo no será una cadena vacía; pero podría serlo si el nombre no tiene prefijo.

Véase también setPrefix(), localName(), namespaceURI(), QDomDocument::createElementNS() y QDomDocument::createAttributeNS().

QDomNode QDomNode::previousSibling() const

Devuelve el nodo hermano anterior en el árbol del documento. Al modificar el nodo devuelto, también se modificará el nodo en el árbol del documento.

Por ejemplo, si tienes un XML como este:

<h1>Heading</h1>
<p>The text...</p>
<h2>Next heading</h2>

y este QDomNode representa la etiqueta &lt;p&gt;, previousSibling() devolverá el nodo que representa la etiqueta &lt;h1&gt;.

Véase también nextSibling().

QDomElement QDomNode::previousSiblingElement(const QString &tagName = QString(), const QString &namespaceURI = QString()) const

Devuelve el elemento hermano anterior con el nombre de etiqueta tagName y el URI del espacio de nombres namespaceURI. Si tagName está vacío, devuelve el elemento hermano anterior con namespaceURI, y si namespaceURI está vacío, devuelve el elemento hermano anterior con tagName. Si ambos parámetros están vacíos, devuelve el elemento hermano anterior. Devuelve un elemento nulo si no existe dicho elemento hermano.

Véase también firstChildElement(), nextSiblingElement() y lastChildElement().

QDomNode QDomNode::removeChild(const QDomNode &oldChild)

Elimina « oldChild » de la lista de elementos secundarios. « oldChild » debe ser un elemento secundario directo de este nodo.

Devuelve una nueva referencia a oldChild si la operación se realiza correctamente, o un null node si falla.

Véase también insertBefore(), insertAfter(), replaceChild() y appendChild().

QDomNode QDomNode::replaceChild(const QDomNode &newChild, const QDomNode &oldChild)

Sustituye oldChild por newChild. oldChild debe ser un elemento secundario directo de este nodo.

Si newChild es un elemento secundario de otro nodo, se le asigna como nodo principal este nodo. Si newChild es un elemento secundario de este nodo, se cambia su posición en la lista de elementos secundarios.

Si newChild es un QDomDocumentFragment, entonces oldChild se sustituye por todos los hijos del fragmento.

Devuelve una nueva referencia a ` oldChild ` en caso de éxito o un ` null node ` en caso de fallo.

Véase también insertBefore(), insertAfter(), removeChild() y appendChild().

void QDomNode::save(QTextStream &stream, int indent, QDomNode::EncodingPolicy encodingPolicy = QDomNode::EncodingFromDocument) const

Escribe la representación XML del nodo y de todos sus hijos en el flujo stream. Esta función utiliza indent como valor de la sangría del nodo.

Si el documento contiene caracteres XML no válidos o caracteres que no se pueden codificar en la codificación especificada, el resultado y el comportamiento son indefinidos.

Si encodingPolicy es QDomNode::EncodingFromDocument y este nodo es un nodo de documento, la codificación del flujo de texto stream se establece tratando una instrucción de procesamiento con el nombre «xml» como una declaración XML, si existe alguna; de lo contrario, se utiliza UTF-8 por defecto. Las declaraciones XML no son instrucciones de procesamiento, pero este comportamiento existe por razones históricas. Si este nodo no es un nodo de documento, se utiliza la codificación del flujo de texto.

Si encodingPolicy es EncodingFromTextStream y este nodo es un nodo de documento, esta función se comporta como save(QTextStream &str, int indent), con la excepción de que se utiliza la codificación especificada en el flujo de texto stream.

Si el documento contiene caracteres XML no válidos o caracteres que no se pueden codificar en la codificación indicada, el resultado y el comportamiento son indefinidos.

void QDomNode::setNodeValue(const QString &value)

Establece el valor del nodo en value.

Véase también nodeValue().

void QDomNode::setPrefix(const QString &pre)

Si el nodo tiene un prefijo de espacio de nombres, esta función cambia el prefijo de espacio de nombres del nodo a pre. De lo contrario, esta función no realiza ninguna acción.

Solo los nodos de tipo ElementNode o AttributeNode pueden tener espacios de nombres. El prefijo del espacio de nombres debe especificarse en el momento de la creación; no es posible añadirlo posteriormente.

Véanse también prefix(), localName(), namespaceURI(), QDomDocument::createElementNS() y QDomDocument::createAttributeNS().

QDomAttr QDomNode::toAttr() const

Convierte un ` QDomNode ` en un ` QDomAttr`. Si el nodo no es un atributo, el objeto devuelto será ` null`.

Véase también isAttr().

QDomCDATASection QDomNode::toCDATASection() const

Convierte un ` QDomNode ` en un ` QDomCDATASection`. Si el nodo no es una sección CDATA, el objeto devuelto será ` null`.

Véase también isCDATASection().

QDomCharacterData QDomNode::toCharacterData() const

Convierte un ` QDomNode ` en un ` QDomCharacterData`. Si el nodo no es un nodo de datos de carácter, el objeto devuelto será ` null`.

Véase también isCharacterData().

QDomComment QDomNode::toComment() const

Convierte un ` QDomNode ` en un ` QDomComment`. Si el nodo no es un comentario, el objeto devuelto será ` null`.

Véase también isComment().

QDomDocument QDomNode::toDocument() const

Convierte un ` QDomNode ` en un ` QDomDocument`. Si el nodo no es un documento, el objeto devuelto será ` null`.

Véase también isDocument().

QDomDocumentFragment QDomNode::toDocumentFragment() const

Convierte un ` QDomNode ` en un ` QDomDocumentFragment`. Si el nodo no es un fragmento de documento, el objeto devuelto será ` null`.

Véase también isDocumentFragment().

QDomDocumentType QDomNode::toDocumentType() const

Convierte un ` QDomNode ` en un ` QDomDocumentType`. Si el nodo no es un tipo de documento, el objeto devuelto será ` null`.

Véase también isDocumentType().

QDomElement QDomNode::toElement() const

Convierte un ` QDomNode ` en un ` QDomElement`. Si el nodo no es un elemento, el objeto devuelto será ` null`.

Véase también isElement().

QDomEntity QDomNode::toEntity() const

Convierte un ` QDomNode ` en un ` QDomEntity`. Si el nodo no es una entidad, el objeto devuelto será ` null`.

Véase también isEntity().

QDomEntityReference QDomNode::toEntityReference() const

Convierte un objeto ` QDomNode ` en un objeto ` QDomEntityReference`. Si el nodo no es una referencia a una entidad, el objeto devuelto será ` null`.

Véase también isEntityReference().

QDomNotation QDomNode::toNotation() const

Convierte un ` QDomNode ` en un ` QDomNotation`. Si el nodo no es una notación, el objeto devuelto será ` null`.

Véase también isNotation().

QDomProcessingInstruction QDomNode::toProcessingInstruction() const

Convierte un ` QDomNode ` en un ` QDomProcessingInstruction`. Si el nodo no es una instrucción de procesamiento, el objeto devuelto será ` null`.

Véase también isProcessingInstruction().

QDomText QDomNode::toText() const

Convierte un ` QDomNode ` en un ` QDomText`. Si el nodo no es un texto, el objeto devuelto será un ` null`.

Véase también isText().

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

Devuelve « true » si « other » y este nodo DOM no son iguales; en caso contrario, devuelve « false ».

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

Asigna una copia de ` other ` a este nodo DOM.

Los datos de la copia son compartidos (copia superficial): al modificar un nodo, también se modificará el otro. Si deseas realizar una copia profunda, utiliza cloneNode().

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

Devuelve ` true ` si ` other ` y este nodo DOM son iguales; en caso contrario, devuelve ` false`.

Cualquier instancia de ` QDomNode ` actúa como una referencia a una estructura de datos subyacente en ` QDomDocument`. La comprobación de igualdad verifica si las dos referencias apuntan al mismo nodo subyacente. Por ejemplo:

QDomDocument document;
QDomElement element1 = document.documentElement();
QDomElement element2 = element1;

Los dos nodos (QDomElement es una subclase de QDomNode ) hacen referencia al elemento raíz del documento, y element1 == element2 devolverá «true». Por otro lado:

QDomElement element3 = document.createElement("MyElement");
QDomElement element4 = document.createElement("MyElement");

Aunque ambos nodos sean elementos vacíos con el mismo nombre, element3 == element4 devolverá «false», ya que hacen referencia a dos nodos diferentes en la estructura de datos subyacente.

Elementos no miembros relacionados

QTextStream &operator<<(QTextStream &str, const QDomNode &node)

Escribe la representación XML del nodo « node » y todos sus elementos hijos en el flujo « str ».

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