Sur cette page

QDomNodeList Class

La classe `QDomNodeList` est une liste d'objets ` QDomNode `. En savoir plus...

En-tête : #include <QDomNodeList>
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.

Types publics

(since 6.9) const_iterator
(since 6.9) const_pointer
(since 6.9) const_reference
(since 6.9) const_reverse_iterator
(since 6.9) difference_type
(since 6.9) pointer
(since 6.9) reference
(since 6.9) value_type

Fonctions publiques

QDomNodeList()
QDomNodeList(const QDomNodeList &nodeList)
~QDomNodeList()
QDomNode at(int index) const
(since 6.9) QDomNodeList::const_iterator begin() const
(since 6.9) QDomNodeList::const_iterator cbegin() const
(since 6.9) QDomNodeList::const_iterator cend() const
(since 6.9) QDomNodeList::const_iterator constBegin() const
(since 6.9) QDomNodeList::const_iterator constEnd() const
int count() const
(since 6.9) QDomNodeList::const_reverse_iterator crbegin() const
(since 6.9) QDomNodeList::const_reverse_iterator crend() const
(since 6.9) QDomNodeList::const_iterator end() const
bool isEmpty() const
QDomNode item(int index) const
int length() const
(since 6.9) QDomNodeList::const_reverse_iterator rbegin() const
(since 6.9) QDomNodeList::const_reverse_iterator rend() const
int size() const
QDomNodeList &operator=(const QDomNodeList &other)
bool operator!=(const QDomNodeList &lhs, const QDomNodeList &rhs)
bool operator==(const QDomNodeList &lhs, const QDomNodeList &rhs)

Description détaillée

Les listes peuvent être obtenues à l'aide des méthodes QDomDocument::elementsByTagName() et QDomNode::childNodes(). Le modèle objet de document (DOM) exige que ces listes soient « dynamiques » : chaque fois que vous modifiez le document sous-jacent, le contenu de la liste est mis à jour.

Vous pouvez récupérer un nœud particulier de la liste à l'aide de la méthode item(). Le nombre d'éléments de la liste est renvoyé par la méthode length().

Pour plus d’informations sur le Modèle d’objet document, consultez les spécifications Core de niveau 1 et de niveau 2. Pour une introduction plus générale à l’implémentation du DOM, consultez la documentation relative à QDomDocument.

Voir également QDomNode::childNodes() et QDomDocument::elementsByTagName().

Documentation sur les types de membres

[alias, since 6.9] QDomNodeList::const_iterator

[alias, since 6.9] QDomNodeList::const_reverse_iterator

Définitions de type pour une classe opaque qui implémente un itérateur bidirectionnel sur une ` QDomNodeList`.

Remarque : l’ QDomNodeList ne prend pas en charge la modification des nœuds in situ ; il n’existe donc pas d’itérateur mutable.

Ces définitions de type ont été introduites dans Qt 6.9.

[alias, since 6.9] QDomNodeList::const_pointer

[alias, since 6.9] QDomNodeList::const_reference

[alias, since 6.9] QDomNodeList::difference_type

[alias, since 6.9] QDomNodeList::pointer

[alias, since 6.9] QDomNodeList::reference

[alias, since 6.9] QDomNodeList::value_type

Prévu pour assurer la compatibilité avec STL.

Remarque : QDomNodeList ne prend pas en charge la modification des nœuds in situ ; par conséquent, « reference » et « const_reference » sont du même type, tout comme « pointer » et « const_pointer ».

Ces définitions de type ont été introduites dans Qt 6.9.

Documentation des fonctions membres

QDomNodeList::QDomNodeList()

Crée une liste de nœuds vide.

QDomNodeList::QDomNodeList(const QDomNodeList &nodeList)

Crée une copie de nodeList.

[noexcept] QDomNodeList::~QDomNodeList()

Détruit l'objet et libère ses ressources.

QDomNode QDomNodeList::at(int index) const

Cette fonction est fournie dans un souci de cohérence de l'API Qt. Elle est équivalente à item().

Si index est négatif ou si index >= length(), alors un nœud nul est renvoyé (c'est-à-dire un nœud pour lequel QDomNode::isNull() renvoie true).

[noexcept, since 6.9] QDomNodeList::const_iterator QDomNodeList::begin() const

[noexcept, since 6.9] QDomNodeList::const_iterator QDomNodeList::cbegin() const

[noexcept, since 6.9] QDomNodeList::const_iterator QDomNodeList::cend() const

[noexcept, since 6.9] QDomNodeList::const_iterator QDomNodeList::constBegin() const

[noexcept, since 6.9] QDomNodeList::const_iterator QDomNodeList::constEnd() const

[noexcept, since 6.9] QDomNodeList::const_iterator QDomNodeList::end() const

[noexcept, since 6.9] QDomNodeList::const_reverse_iterator QDomNodeList::crbegin() const

[noexcept, since 6.9] QDomNodeList::const_reverse_iterator QDomNodeList::crend() const

[noexcept, since 6.9] QDomNodeList::const_reverse_iterator QDomNodeList::rbegin() const

[noexcept, since 6.9] QDomNodeList::const_reverse_iterator QDomNodeList::rend() const

Renvoie respectivement un ` const_iterator ` ou un ` const_reverse_iterator`, pointant vers le premier élément de la liste ou vers l'élément suivant le dernier.

Remarque : ` QDomNodeList ` ne prend pas en charge la modification des nœuds sur place ; il n'existe donc pas d'itérateur modifiable.

Ces fonctions ont été introduites dans Qt 6.9.

int QDomNodeList::count() const

Cette fonction est fournie dans un souci de cohérence de l'API Qt. Elle est équivalente à ` length()`.

bool QDomNodeList::isEmpty() const

Renvoie « true » si la liste ne contient aucun élément ; sinon, renvoie « false ». Cette fonction est fournie pour assurer la cohérence de l'API Qt.

QDomNode QDomNodeList::item(int index) const

Renvoie le nœud situé à la position index.

Si index est négatif ou si index >= length() alors un nœud nul est renvoyé (c'est-à-dire un nœud pour lequel QDomNode::isNull() renvoie vrai).

Voir également length().

int QDomNodeList::length() const

Renvoie le nombre de nœuds de la liste.

int QDomNodeList::size() const

Cette fonction est fournie dans un souci de cohérence de l'API Qt. Elle équivaut à ` length()`.

QDomNodeList &QDomNodeList::operator=(const QDomNodeList &other)

Attribue « other » à cette liste de nœuds.

Personnes non membres associées

[noexcept] bool operator!=(const QDomNodeList &lhs, const QDomNodeList &rhs)

Renvoie « true » si les listes « lhs » et « rhs » du nœud ne sont pas identiques ; sinon, renvoie « false ».

[noexcept] bool operator==(const QDomNodeList &lhs, const QDomNodeList &rhs)

Renvoie « true » si les listes lhs et rhs du nœud 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.