QDomNodeList Class
QDomNodeList 类是一个由QDomNode 对象组成的列表。更多内容...
| 头文件： | #include <QDomNodeList> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS Xml) target_link_libraries(mytarget PRIVATE Qt6::Xml) |
| qmake： | QT += xml |
- 所有成员的列表，包括继承的成员
- QDomNodeList 属于XML 类。
注意：该类中的所有函数均为可重入函数。
公共类型
(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 |
公共函数
| 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) |
详细说明
可以通过 `QDomDocument::elementsByTagName()` 和 `QDomNode::childNodes()` 获取列表。文档对象模型 (DOM) 要求这些列表是“实时”的：每当您更改底层文档时，列表的内容都会随之更新。
您可以使用item() 从列表中获取特定节点。列表中的项目数量可通过length() 获取。
有关文档对象模型（DOM）的更多信息，请参阅Level 1和Level 2 Core。有关 DOM 实现的更通用的介绍，请参阅QDomDocument 文档。
另请参阅 QDomNode::childNodes() 和QDomDocument::elementsByTagName()。
成员类型文档
[alias, since 6.9] QDomNodeList::const_iterator
[alias, since 6.9] QDomNodeList::const_reverse_iterator
针对一个实现QDomNodeList 双向迭代器的不透明类的typedef定义。
注意： QDomNodeList 不支持就地修改节点，因此不存在可变迭代器。
这些类型定义在 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
为兼容 STL 而提供。
注意： QDomNodeList 不支持就地修改节点，因此reference和const_reference 属于同一类型，pointer和const_pointer 也是如此。
这些类型别名（typedefs）在 Qt 6.9 中引入。
成员函数文档
QDomNodeList::QDomNodeList()
创建一个空节点列表。
QDomNodeList::QDomNodeList(const QDomNodeList &nodeList)
创建nodeList 的副本。
[noexcept] QDomNodeList::~QDomNodeList()
销毁该对象并释放其资源。
QDomNode QDomNodeList::at(int index) const
提供此函数是为了保持 Qt API 的一致性。它等同于item()。
如果 `index ` 为负数，或者 `index ` >= `length()`，则返回一个空节点（即一个对 `QDomNode::isNull()` 返回 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
分别返回一个指向列表中第一个元素的const_iterator ，或指向列表中最后一个元素之后第一个元素的const_reverse_iterator 。
注意： QDomNodeList 不支持就地修改节点，因此没有可变迭代器。
这些函数是在 Qt 6.9 中引入的。
int QDomNodeList::count() const
提供此函数是为了保持 Qt API 的一致性。它等同于length()。
bool QDomNodeList::isEmpty() const
如果列表中没有项目，则返回true ；否则返回false 。提供此函数是为了保持Qt XML API的一致性。
QDomNode QDomNodeList::item(int index) const
返回位于位置index 的节点。
如果index 为负数，或者index >=length()，则返回一个空节点（即QDomNode::isNull()返回true的节点）。
另请参阅 length()。
int QDomNodeList::length() const
返回列表中的节点数量。
int QDomNodeList::size() const
提供此函数是为了保持 Qt API 的一致性。它等同于length()。
QDomNodeList &QDomNodeList::operator=(const QDomNodeList &other)
将other 分配给此节点列表。
相关非成员
[noexcept] bool operator!=(const QDomNodeList &lhs, const QDomNodeList &rhs)
如果节点的列表lhs 和rhs 不相等，则返回true ；否则返回false 。
[noexcept] bool operator==(const QDomNodeList &lhs, const QDomNodeList &rhs)
如果节点的lhs 和rhs 相等，则返回true ；否则返回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.
