QDomNamedNodeMap Class
La clase QDomNamedNodeMap contiene una colección de nodos a los que se puede acceder por nombre. Más información...
| Encabezado: | #include <QDomNamedNodeMap> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Xml) target_link_libraries(mytarget PRIVATE Qt6::Xml) |
| qmake: | QT += xml |
- Lista de todos los miembros, incluidos los miembros heredados
- QDomNamedNodeMap forma parte de las clases XML.
Nota: Todas las funciones de esta clase son reentrantes.
Funciones públicas
| QDomNamedNodeMap() | |
| QDomNamedNodeMap(const QDomNamedNodeMap &namedNodeMap) | |
| ~QDomNamedNodeMap() | |
| bool | contains(const QString &name) const |
| int | count() const |
| bool | isEmpty() const |
| QDomNode | item(int index) const |
| int | length() const |
| QDomNode | namedItem(const QString &name) const |
| QDomNode | namedItemNS(const QString &nsURI, const QString &localName) const |
| QDomNode | removeNamedItem(const QString &name) |
| QDomNode | removeNamedItemNS(const QString &nsURI, const QString &localName) |
| QDomNode | setNamedItem(const QDomNode &newNode) |
| QDomNode | setNamedItemNS(const QDomNode &newNode) |
| int | size() const |
| bool | operator!=(const QDomNamedNodeMap &other) const |
| QDomNamedNodeMap & | operator=(const QDomNamedNodeMap &other) |
| bool | operator==(const QDomNamedNodeMap &other) const |
Descripción detallada
Tenga en cuenta que `QDomNamedNodeMap` no hereda de ` QDomNodeList`. Los `QDomNamedNodeMap` no proporcionan ningún orden específico de los nodos. Aunque se puede acceder a los nodos de un `QDomNamedNodeMap` mediante un índice ordinal, esto solo sirve para permitir una enumeración cómoda del contenido de un `QDomNamedNodeMap` y no implica que el DOM especifique un orden de los nodos.
El QDomNamedNodeMap se utiliza en tres casos:
- QDomDocumentType::entities() devuelve un mapa de todas las entidades descritas en la DTD.
- QDomDocumentType::notations() devuelve un mapa de todas las notaciones descritas en la DTD.
- QDomNode::attributes() devuelve un mapa de todos los atributos de un elemento.
Los elementos del mapa se identifican mediante el nombre que devuelve QDomNode::name(). Los nodos se recuperan mediante namedItem(), namedItemNS() o item(). Los nuevos nodos se insertan con setNamedItem() o setNamedItemNS() y se eliminan con removeNamedItem() o removeNamedItemNS(). Utiliza contains() para comprobar si un elemento con el nombre dado se encuentra en el mapa de nodos especificado. El número de elementos se obtiene mediante length().
Terminología: en esta clase utilizamos los términos «elemento» y «nodo» indistintamente.
Documentación de las funciones miembro
QDomNamedNodeMap::QDomNamedNodeMap()
Crea un mapa de nodos con nombre vacío.
QDomNamedNodeMap::QDomNamedNodeMap(const QDomNamedNodeMap &namedNodeMap)
Crea una copia de namedNodeMap.
[noexcept] QDomNamedNodeMap::~QDomNamedNodeMap()
Destruye el objeto y libera sus recursos.
bool QDomNamedNodeMap::contains(const QString &name) const
Devuelve « true » si el mapa contiene un nodo llamado « name »; en caso contrario, devuelve « false ».
Nota: Esta función no tiene en cuenta la presencia de espacios de nombres. Utiliza namedItemNS() para comprobar si el mapa contiene un nodo con un URI de espacio de nombres y un nombre específicos.
int QDomNamedNodeMap::count() const
Esta función se proporciona para garantizar la coherencia de la API de Qt. Es equivalente a ` length()`.
bool QDomNamedNodeMap::isEmpty() const
Devuelve « true » si el mapa está vacío; en caso contrario, devuelve « false ». Esta función se incluye para garantizar la coherencia de la API de Qt.
QDomNode QDomNamedNodeMap::item(int index) const
Recupera el nodo situado en la posición index.
Esto se puede utilizar para recorrer el mapa. Ten en cuenta que los nodos del mapa están ordenados de forma arbitraria.
Véase también length().
int QDomNamedNodeMap::length() const
Devuelve el número de nodos del mapa.
Véase también item().
QDomNode QDomNamedNodeMap::namedItem(const QString &name) const
Devuelve el nodo denominado « name ».
Si el mapa de nodos con ese nombre no contiene dicho nodo, se devuelve un ` null node `. El nombre de un nodo es el nombre devuelto por ` QDomNode::nodeName()`.
Véanse también setNamedItem() y namedItemNS().
QDomNode QDomNamedNodeMap::namedItemNS(const QString &nsURI, const QString &localName) const
Devuelve el nodo asociado al nombre local localName y al URI del espacio de nombres nsURI.
Si el mapa no contiene dicho nodo, se devuelve un null node.
Véase también setNamedItemNS() y namedItem().
QDomNode QDomNamedNodeMap::removeNamedItem(const QString &name)
Elimina del mapa el nodo denominado « name ».
La función devuelve el nodo eliminado o un ` null node ` si el mapa no contenía ningún nodo llamado ` name`.
Véanse también setNamedItem(), namedItem() y removeNamedItemNS().
QDomNode QDomNamedNodeMap::removeNamedItemNS(const QString &nsURI, const QString &localName)
Elimina del mapa el nodo con el nombre local « localName » y el URI del espacio de nombres « nsURI ».
La función devuelve el nodo eliminado o un null node si el mapa no contenía ningún nodo con el nombre local localName y el URI del espacio de nombres nsURI.
Véanse también setNamedItemNS(), namedItemNS() y removeNamedItem().
QDomNode QDomNamedNodeMap::setNamedItem(const QDomNode &newNode)
Inserta el nodo newNode en el mapa de nodos con el nombre indicado. El nombre que utiliza el mapa es el nombre del nodo newNode, tal y como lo devuelve la función QDomNode::nodeName().
Si el nuevo nodo sustituye a uno ya existente, es decir, si el mapa contiene un nodo con el mismo nombre, se devuelve el nodo sustituido.
Véanse también namedItem(), removeNamedItem() y setNamedItemNS().
QDomNode QDomNamedNodeMap::setNamedItemNS(const QDomNode &newNode)
Inserta el nodo newNode en el mapa. Si ya existe en el mapa un nodo con el mismo URI de espacio de nombres y el mismo nombre local, este se sustituye por newNode. Si el nuevo nodo sustituye a uno ya existente, se devuelve el nodo sustituido.
Véase también namedItemNS(), removeNamedItemNS() y setNamedItem().
int QDomNamedNodeMap::size() const
Esta función se proporciona para garantizar la coherencia de la API de Qt. Es equivalente a ` length()`.
bool QDomNamedNodeMap::operator!=(const QDomNamedNodeMap &other) const
Devuelve « true » si « other » y este mapa de nodos con nombre no son iguales; en caso contrario, devuelve « false ».
QDomNamedNodeMap &QDomNamedNodeMap::operator=(const QDomNamedNodeMap &other)
Asigna « other » a este mapa de nodos con nombre.
bool QDomNamedNodeMap::operator==(const QDomNamedNodeMap &other) const
Devuelve « true » si « other » y este mapa de nodos con nombre son iguales; 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.