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: |
- Lista de todos los miembros, incluidos los miembros heredados
- QDomNode forma parte de las clases XML.
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 |
Elementos no miembros relacionados
| 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.
| Constante | Valor | Descripción |
|---|---|---|
QDomNode::EncodingFromDocument | 1 | La codificación se obtiene del documento. |
QDomNode::EncodingFromTextStream | 2 | La codificación se obtiene de QTextStream. |
Véase también QDomNode::save().
enum QDomNode::NodeType
Esta enumeración define el tipo del nodo:
| Constante | Valor | Descripción |
|---|---|---|
QDomNode::ElementNode | 1 | |
QDomNode::AttributeNode | 2 | |
QDomNode::TextNode | 3 | |
QDomNode::CDATASectionNode | 4 | |
QDomNode::EntityReferenceNode | 5 | |
QDomNode::EntityNode | 6 | |
QDomNode::ProcessingInstructionNode | 7 | |
QDomNode::CommentNode | 8 | |
QDomNode::DocumentNode | 9 | |
QDomNode::DocumentTypeNode | 10 | |
QDomNode::DocumentFragmentNode | 11 | |
QDomNode::NotationNode | 12 | |
QDomNode::BaseNode | 21 | Un objeto de tipo « QDomNode », es decir, que no sea una subclase de « QDomNode ». |
QDomNode::CharacterDataNode | 22 |
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 <h1> y el nodo creado por la etiqueta <p>.
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:
| Nombre | Significado |
|---|---|
| QDomAttr | El nombre del atributo |
| QDomCDATASection | La cadena «#cdata-section» |
| QDomComment | La cadena «#comment» |
| QDomDocument | La cadena «#document» |
| QDomDocumentFragment | La cadena «#document-fragment» |
| QDomDocumentType | El nombre del tipo de documento |
| QDomElement | El nombre de la etiqueta |
| QDomEntity | El nombre de la entidad |
| QDomEntityReference | El nombre de la entidad a la que se hace referencia |
| QDomNotation | El nombre de la notación |
| QDomProcessingInstruction | El destino de la instrucción de procesamiento |
| QDomText | La 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:
| Nombre | Significado |
|---|---|
| QDomAttr | El valor del atributo |
| QDomCDATASection | El contenido de la sección CDATA |
| QDomComment | El comentario |
| QDomProcessingInstruction | Los datos de la instrucción de procesamiento |
| QDomText | El 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 <p>, previousSibling() devolverá el nodo que representa la etiqueta <h1>.
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.