Sur cette page

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

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 :

  1. QDomDocumentType::entities() renvoie une carte de toutes les entités décrites dans la DTD.
  2. QDomDocumentType::notations() renvoie une carte de toutes les notations décrites dans la DTD.
  3. 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.