QDomNodeList Class
The QDomNodeList class is a list of QDomNode objects. More...
| Header: | #include <QDomNodeList> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Xml)target_link_libraries(mytarget PRIVATE Qt6::Xml) |
| qmake: | QT += xml |
- List of all members, including inherited members
- QDomNodeList is part of XML Classes.
Note: All functions in this class are reentrant.
Public Types
(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) | size_type |
(since 6.9) | value_type |
Public Functions
| 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) |
Related Non-Members
| bool | operator!=(const QDomNodeList &lhs, const QDomNodeList &rhs) |
| bool | operator==(const QDomNodeList &lhs, const QDomNodeList &rhs) |
Detailed Description
Lists can be obtained by QDomDocument::elementsByTagName() and QDomNode::childNodes(). The Document Object Model (DOM) requires these lists to be "live": whenever you change the underlying document, the contents of the list will get updated.
You can get a particular node from the list with item(). The number of items in the list is returned by length().
For further information about the Document Object Model see Level 1 and Level 2 Core. For a more general introduction of the DOM implementation see the QDomDocument documentation.
See also QDomNode::childNodes() and QDomDocument::elementsByTagName().
Member Type Documentation
[alias, since 6.9] QDomNodeList::const_iterator
[alias, since 6.9] QDomNodeList::const_reverse_iterator
Typedefs for an opaque class that implements a (reverse) random-access iterator over a QDomNodeList.
Note: QDomNodeList does not support modifying nodes in-place, so there is no mutable iterator.
This typedef was introduced in 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::size_type
[alias, since 6.9] QDomNodeList::value_type
Provided for STL-compatibility.
Note: QDomNodeList does not support modifying nodes in-place, so reference and const_reference are the same type, as are pointer and const_pointer.
This typedef was introduced in Qt 6.9.
Member Function Documentation
[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
Returns a const_iterator or const_reverse_iterator, respectively, pointing to the first or one past the last item in the list.
Note: QDomNodeList does not support modifying nodes in-place, so there is no mutable iterator.
This function was introduced in Qt 6.9.
QDomNodeList::QDomNodeList()
Creates an empty node list.
QDomNodeList::QDomNodeList(const QDomNodeList &nodeList)
Constructs a copy of nodeList.
[noexcept] QDomNodeList::~QDomNodeList()
Destroys the object and frees its resources.
QDomNode QDomNodeList::at(int index) const
This function is provided for Qt API consistency. It is equivalent to item().
If index is negative or if index >= length() then a null node is returned (i.e. a node for which QDomNode::isNull() returns true).
int QDomNodeList::count() const
This function is provided for Qt API consistency. It is equivalent to length().
bool QDomNodeList::isEmpty() const
Returns true if the list contains no items; otherwise returns false. This function is provided for Qt API consistency.
QDomNode QDomNodeList::item(int index) const
Returns the node at position index.
If index is negative or if index >= length() then a null node is returned (i.e. a node for which QDomNode::isNull() returns true).
See also length().
int QDomNodeList::length() const
Returns the number of nodes in the list.
int QDomNodeList::size() const
This function is provided for Qt API consistency. It is equivalent to length().
QDomNodeList &QDomNodeList::operator=(const QDomNodeList &other)
Assigns other to this node list.
Related Non-Members
[noexcept] bool operator!=(const QDomNodeList &lhs, const QDomNodeList &rhs)
Returns true if the node lists lhs and rhs are not equal; otherwise returns false.
[noexcept] bool operator==(const QDomNodeList &lhs, const QDomNodeList &rhs)
Returns true if the node lists lhs and rhs are equal; otherwise returns false.
© 2024 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.
