- Qt 6.8
- Qt XML
- C++ Classes
- QDomNodeList
- Qt 6.8.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 Functions

| QDomNodeList()
| QDomNodeList(const QDomNodeList &nodeList)
| ~QDomNodeList()
QDomNode | at(int index) const
int | count() const
bool | isEmpty() const
QDomNode | item(int index) const
int | length() const
int | size() const
bool | operator!=(const QDomNodeList &other) const
QDomNodeList & | operator=(const QDomNodeList &other)
bool | operator==(const QDomNodeList &other) const

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

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

### bool QDomNodeList::operator!=(const QDomNodeList &other) const

Returns `true` the node list other and this node list are not equal; otherwise returns `false`.

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

Assigns other to this node list.

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

Returns `true` if the node list other and this node list are equal; otherwise returns `false`.