QDomNodeList Class | Qt XML | Qt 6.11.0
Description: The QDomNodeList class is a list of QDomNode objects.

- Qt 6.11
- Qt XML
- C++ Classes
- QDomNodeList
- Qt 6.11.0 Reference Documentation

# 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)` | 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 bidirectional iterator over a QDomNodeList.

Note: QDomNodeList does not support modifying nodes in-place, so there is no mutable iterator.

These typedefs were 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::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.

These typedefs were introduced in Qt 6.9.

## Member Function Documentation

### 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).

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

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

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

### `[noexcept, since 6.9]` QDomNodeList::const_reverse_iterator QDomNodeList::rend() 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_reverse_iterator QDomNodeList::crbegin() const

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

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

### `[noexcept, since 6.9]` QDomNodeList::const_iterator QDomNodeList::constEnd() 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.

These functions were introduced in Qt 6.9.

### 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`.