QDomNamedNodeMap Class
La classe QDomNamedNodeMap contient une collection de nœuds accessibles par leur nom. Plus d'informations...
| 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.
Note : 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 QDomNamedNodeMaps ne fournissent pas d'ordre spécifique pour les nœuds. Bien que les nœuds d'un QDomNamedNodeMap puissent être accédés par un index ordinal, cela permet simplement une é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 carte sont identifiés par le nom que QDomNode::name() renvoie. Les nœuds sont récupérés à l'aide de namedItem(), namedItemNS() ou item(). Les nouveaux nœuds sont insérés avec setNamedItem() ou setNamedItemNS() et supprimés avec removeNamedItem() ou removeNamedItemNS(). Utilisez contains() pour vérifier si un élément portant le nom donné se trouve dans la carte des nœuds nommés. Le nombre d'éléments est renvoyé par length().
Terminologie : dans cette classe, nous utilisons indifféremment "item" et "node".
Documentation des fonctions membres
QDomNamedNodeMap::QDomNamedNodeMap()
Construit une carte de nœuds nommés vide.
QDomNamedNodeMap::QDomNamedNodeMap(const QDomNamedNodeMap &namedNodeMap)
Construit 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 appelé name; sinon, elle renvoie false.
Remarque : cette fonction ne tient pas compte de la présence d'espaces de noms. Utilisez namedItemNS() pour vérifier si la carte contient un nœud avec un URI et un nom d'espace de noms spécifiques.
int QDomNamedNodeMap::count() const
Cette fonction est fournie pour assurer la 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 à la position index.
Ceci peut être utilisé pour itérer sur la carte. Notez que les nœuds de la carte sont ordonnés de manière arbitraire.
Voir aussi length().
int QDomNamedNodeMap::length() const
Renvoie le nombre de nœuds dans la carte.
Voir aussi item().
QDomNode QDomNamedNodeMap::namedItem(const QString &name) const
Renvoie le nœud appelé name.
Si la carte des nœuds nommés ne contient pas un tel nœud, null node est renvoyé. Le nom d'un noeud est le nom retourné par QDomNode::nodeName().
Voir aussi 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 de l'espace de noms nsURI.
Si la carte ne contient pas un tel nœud, elle renvoie null node.
Voir aussi setNamedItemNS() et namedItem().
QDomNode QDomNamedNodeMap::removeNamedItem(const QString &name)
Supprime de la carte le nœud appelé name.
La fonction renvoie le nœud supprimé ou un null node si la carte ne contient pas de nœud appelé name.
Voir aussi 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 de l'espace de noms nsURI.
La fonction renvoie le nœud supprimé ou un null node si la carte ne contient pas de nœud portant le nom local localName et l'URI de l'espace de noms nsURI.
Voir aussi setNamedItemNS(), namedItemNS() et removeNamedItem().
QDomNode QDomNamedNodeMap::setNamedItem(const QDomNode &newNode)
Insère le nœud newNode dans la carte des nœuds nommés. Le nom utilisé par la carte est le nom du nœud newNode tel qu'il est renvoyé par 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 aussi namedItem(), removeNamedItem() et setNamedItemNS().
QDomNode QDomNamedNodeMap::setNamedItemNS(const QDomNode &newNode)
Insère le nœud newNode dans la carte. Si un nœud ayant 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 aussi namedItemNS(), removeNamedItemNS() et setNamedItem().
int QDomNamedNodeMap::size() const
Cette fonction est fournie pour assurer la 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és ne sont pas égaux ; sinon, renvoie false.
QDomNamedNodeMap &QDomNamedNodeMap::operator=(const QDomNamedNodeMap &other)
Attribue 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és 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.
