QDomNamedNodeMap Class
La clase QDomNamedNodeMap contiene una colección de nodos a los que se puede acceder por su nombre. Más...
| Cabecera: | #include <QDomNamedNodeMap> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Xml)target_link_libraries(mytarget PRIVATE Qt6::Xml) |
| qmake: | QT += xml |
- Lista de todos los miembros, incluyendo los heredados
- QDomNamedNodeMap es parte de XML Classes.
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. QDomNamedNodeMaps no proporciona ningún orden específico de los nodos. Aunque se puede acceder a los nodos de un QDomNamedNodeMap mediante un índice ordinal, esto es simplemente para permitir una enumeración conveniente de los contenidos de un QDomNamedNodeMap, y no implica que el DOM especifique un orden de los nodos.
El QDomNamedNodeMap se utiliza en tres lugares:
- 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 por el nombre que devuelve QDomNode::name(). Los nodos se recuperan con namedItem(), namedItemNS() o item(). Los nuevos nodos se insertan con setNamedItem() o setNamedItemNS() y se eliminan con removeNamedItem() o removeNamedItemNS(). Utilice contains() para ver si un elemento con el nombre dado se encuentra en el mapa de nodos con nombre. El número de elementos se devuelve con length().
Terminología: en esta clase utilizamos "elemento" y "nodo" indistintamente.
Documentación de las funciones miembro
QDomNamedNodeMap::QDomNamedNodeMap()
Construye un mapa de nodos con nombre vacío.
QDomNamedNodeMap::QDomNamedNodeMap(const QDomNamedNodeMap &namedNodeMap)
Construye 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. Utilice namedItemNS() para comprobar si el mapa contiene un nodo con un URI y un nombre de espacio de nombres específicos.
int QDomNamedNodeMap::count() const
Esta función se proporciona por coherencia con 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 proporciona por coherencia con la API de Qt.
QDomNode QDomNamedNodeMap::item(int index) const
Recupera el nodo en la posición index.
Puede utilizarse para iterar sobre el mapa. Tenga en cuenta que los nodos del mapa están ordenados arbitrariamente.
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 llamado name.
Si el mapa de nodos con nombre no contiene tal nodo, se devuelve null node. El nombre de un nodo es el nombre devuelto por QDomNode::nodeName().
Véase 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 null node.
Véase también setNamedItemNS() y namedItem().
QDomNode QDomNamedNodeMap::removeNamedItem(const QString &name)
Elimina el nodo llamado name del mapa.
La función devuelve el nodo eliminado o un null node si el mapa no contenía un nodo llamado name.
Véase también setNamedItem(), namedItem(), y removeNamedItemNS().
QDomNode QDomNamedNodeMap::removeNamedItemNS(const QString &nsURI, const QString &localName)
Elimina el nodo con el nombre local localName y el espacio de nombres URI nsURI del mapa.
La función devuelve el nodo eliminado o un null node si el mapa no contenía un nodo con el nombre local localName y el URI del espacio de nombres nsURI.
Véase también setNamedItemNS(), namedItemNS() y removeNamedItem().
QDomNode QDomNamedNodeMap::setNamedItem(const QDomNode &newNode)
Inserta el nodo newNode en el mapa de nodos con nombre. El nombre utilizado por el mapa es el nombre de nodo de newNode devuelto por QDomNode::nodeName().
Si el nuevo nodo sustituye a un nodo existente, es decir, el mapa contiene un nodo con el mismo nombre, se devuelve el nodo sustituido.
Véase 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, se sustituye por newNode. Si el nuevo nodo sustituye a un nodo existente, se devuelve el nodo sustituido.
Véase también namedItemNS(), removeNamedItemNS() y setNamedItem().
int QDomNamedNodeMap::size() const
Esta función se proporciona por coherencia con 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.
