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

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
QDomNodeList &operator=(const QDomNodeList &other)
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 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().

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.