QDomNamedNodeMap Class
La classe QDomNamedNodeMap contient un ensemble de nœuds accessibles par leur nom. En savoir plus...
| En-tête : | #include <QDomNamedNodeMap> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Xml) target_link_libraries(mytarget PRIVATE Qt6::Xml) |
| qmake : | QT += xml |
- Liste de tous les membres, y compris les membres hérités
- QDomNamedNodeMap fait partie des classes XML.
Remarque : toutes les fonctions de cette classe sont réentrantes.
Fonctions publiques
| 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 |
Description détaillée
Notez que QDomNamedNodeMap n'hérite pas de QDomNodeList. Les objets QDomNamedNodeMap ne fournissent aucun ordre spécifique des nœuds. Bien que les nœuds d'un QDomNamedNodeMap soient accessibles via un index ordinal, cela sert simplement à permettre un énumération pratique du contenu d'un QDomNamedNodeMap et n'implique pas que le DOM spécifie un ordre des nœuds.
Le `QDomNamedNodeMap` est utilisé à trois endroits :
- QDomDocumentType::entities() renvoie une carte de toutes les entités décrites dans la DTD.
- QDomDocumentType::notations() renvoie une carte de toutes les notations décrites dans la DTD.
- QDomNode::attributes() renvoie une carte de tous les attributs d’un élément.
Les éléments de la table sont identifiés par le nom renvoyé par la méthode QDomNode::name(). Les nœuds sont récupérés à l’aide des méthodes namedItem(), namedItemNS() ou item(). De nouveaux nœuds sont insérés à l’aide de setNamedItem() ou setNamedItemNS() et supprimés à l’aide de removeNamedItem() ou removeNamedItemNS(). Utilisez contains() pour vérifier si un élément portant le nom donné figure dans la table de nœuds nommée. Le nombre d’éléments est renvoyé par length().
Terminologie : dans cette classe, les termes « élément » et « nœud » sont utilisés de manière interchangeable.
Documentation des fonctions membres
QDomNamedNodeMap::QDomNamedNodeMap()
Crée une carte de nœuds nommée vide.
QDomNamedNodeMap::QDomNamedNodeMap(const QDomNamedNodeMap &namedNodeMap)
Crée une copie de namedNodeMap.
[noexcept] QDomNamedNodeMap::~QDomNamedNodeMap()
Détruit l'objet et libère ses ressources.
bool QDomNamedNodeMap::contains(const QString &name) const
Renvoie true si la carte contient un nœud nommé name; sinon, renvoie false.
Remarque : cette fonction ne tient pas compte de l'existence d'espaces de noms. Utilisez ` namedItemNS()` pour vérifier si la carte contient un nœud dont l'URI et le nom correspondent à un espace de noms spécifique.
int QDomNamedNodeMap::count() const
Cette fonction est fournie dans un souci de cohérence de l'API Qt. Elle est équivalente à length().
bool QDomNamedNodeMap::isEmpty() const
Renvoie « true » si la carte est vide ; sinon, renvoie « false ». Cette fonction est fournie pour assurer la cohérence de l'API Qt.
QDomNode QDomNamedNodeMap::item(int index) const
Récupère le nœud situé à la position index.
Cette fonction peut être utilisée pour parcourir la carte. Notez que les nœuds de la carte sont classés dans un ordre arbitraire.
Voir également length().
int QDomNamedNodeMap::length() const
Renvoie le nombre de nœuds de la carte.
Voir aussi item().
QDomNode QDomNamedNodeMap::namedItem(const QString &name) const
Renvoie le nœud nommé « name ».
Si la carte de nœuds nommée ne contient pas ce nœud, une valeur « null node » est renvoyée. Le nom d'un nœud est le nom renvoyé par la fonction QDomNode::nodeName().
Voir également setNamedItem() et namedItemNS().
QDomNode QDomNamedNodeMap::namedItemNS(const QString &nsURI, const QString &localName) const
Renvoie le nœud associé au nom local localName et à l'URI d'espace de noms nsURI.
Si la carte ne contient pas un tel nœud, un null node est renvoyé.
Voir également setNamedItemNS() et namedItem().
QDomNode QDomNamedNodeMap::removeNamedItem(const QString &name)
Supprime le nœud nommé « name » de la carte.
La fonction renvoie le nœud supprimé ou un null node si la carte ne contenait pas de nœud nommé name.
Voir également setNamedItem(), namedItem() et removeNamedItemNS().
QDomNode QDomNamedNodeMap::removeNamedItemNS(const QString &nsURI, const QString &localName)
Supprime de la carte le nœud portant le nom local « localName » et l'URI d'espace de noms « nsURI ».
La fonction renvoie le nœud supprimé ou un null node si la carte ne contenait pas de nœud portant le nom local localName et l’URI d’espace de noms nsURI.
Voir également setNamedItemNS(), namedItemNS() et removeNamedItem().
QDomNode QDomNamedNodeMap::setNamedItem(const QDomNode &newNode)
Insère le nœud newNode dans la carte de nœuds nommée. Le nom utilisé par la carte est le nom de nœud de newNode tel qu'il est renvoyé par la fonction QDomNode::nodeName().
Si le nouveau nœud remplace un nœud existant, c’est-à-dire si la carte contient un nœud portant le même nom, le nœud remplacé est renvoyé.
Voir également namedItem(), removeNamedItem() et setNamedItemNS().
QDomNode QDomNamedNodeMap::setNamedItemNS(const QDomNode &newNode)
Insère le nœud newNode dans la carte. Si un nœud présentant le même URI d'espace de noms et le même nom local existe déjà dans la carte, il est remplacé par newNode. Si le nouveau nœud remplace un nœud existant, le nœud remplacé est renvoyé.
Voir également namedItemNS(), removeNamedItemNS() et setNamedItem().
int QDomNamedNodeMap::size() const
Cette fonction est fournie dans un souci de cohérence de l'API Qt. Elle est équivalente à ` length()`.
bool QDomNamedNodeMap::operator!=(const QDomNamedNodeMap &other) const
Renvoie « true » si « other » et cette carte de nœuds nommée ne sont pas égales ; sinon, renvoie « false ».
QDomNamedNodeMap &QDomNamedNodeMap::operator=(const QDomNamedNodeMap &other)
Attribue la fonction « other » à cette carte de nœuds nommée.
bool QDomNamedNodeMap::operator==(const QDomNamedNodeMap &other) const
Renvoie ` true ` si ` other ` et cette carte de nœuds nommée sont identiques ; sinon, renvoie ` 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.