QDomNamedNodeMap 类

QDomNamedNodeMap 类包含可以按名称访问的节点集合。更多...

头文件	#include <QDomNamedNodeMap>
CMake	find_package(Qt6 REQUIRED COMPONENTS Xml) target_link_libraries(mytarget PRIVATE Qt6::Xml)
qmake	QT += xml

所有成员列表，包括继承的成员
QDomNamedNodeMap 是 XML 类的一部分。

注意： 此类中所有函数都是重入的。

公共函数

	QDomNamedNodeMap()
	QDomNamedNodeMap(const QDomNamedNodeMap &n)
	~QDomNamedNodeMap()
bool	contains(const QString &name) const
int	count() const
bool	isEmpty() const
QDomNode	item(int index) const
int	length() const
QDomNode	namedItem(const QString &name) const
QDomNode	namedItemNS(const QString &nsURI, const QString &localName) const
QDomNode	removeNamedItem(const QString &name)
QDomNode	removeNamedItemNS(const QString &nsURI, const QString &localName)
QDomNode	setNamedItem(const QDomNode &newNode)
QDomNode	setNamedItemNS(const QDomNode &newNode)
int	size() const
bool	operator!=(const QDomNamedNodeMap &n) const
QDomNamedNodeMap &	operator=(const QDomNamedNodeMap &n)
bool	operator==(const QDomNamedNodeMap &n) const

详细说明

请注意，QDomNamedNodeMap 并未继承自 QDomNodeList。QDomNamedNodeMap 不提供特定的节点排序。尽管可以按序号索引访问 QDomNamedNodeMap 中的节点，但这只是为了方便枚举 QDomNamedNodeMap 的内容，并不意味着 DOM 定义了节点的排序。

QDomNamedNodeMap 在三个地方使用

QDomDocumentType::entities() 返回 DTD 中描述的所有实体的映射。
QDomDocumentType::notations() 返回 DTD 中描述的所有符号的映射。
QDomNode::attributes() 返回一个元素的属性映射。

地图中项目通过 QDomNode::name() 返回的名称进行标识。使用 namedItem()、namedItemNS() 或 item() 获取节点。使用 setNamedItem() 或 setNamedItemNS() 插入新节点，并使用 removeNamedItem() 或 removeNamedItemNS() 移除节点。使用 contains() 检查特定名称的项是否存在于命名节点映射中。使用 length() 获取项目数量。

术语：在此类中，我们将 "item" 和 "node" 互换使用。

成员函数文档

QDomNamedNodeMap::QDomNamedNodeMap()

构建一个空的命名节点映射。

QDomNamedNodeMap::QDomNamedNodeMap(const QDomNamedNodeMap &n)

构建 n 的副本。

`[noexcept]` QDomNamedNodeMap::~QDomNamedNodeMap()

销毁对象并释放其资源。

bool QDomNamedNodeMap::contains(const QString &name) const

如果映射包含名为 name 的节点，则返回 true；否则返回 false。

注意：此函数不考虑命名空间的存在。使用 namedItemNS() 测试映射是否包含具有特定命名空间 URI 和名称的节点。

int QDomNamedNodeMap::count() const

此函数提供 Qt API 一致性。它相当于 length。

bool QDomNamedNodeMap::isEmpty() const

如果映射为空，则返回 true；否则返回 false。此函数提供 Qt API 一致性。

QDomNode QDomNamedNodeMap::item(int index) const

检索位于 index 位置的节点。

这可以用来遍历映射。请注意，映射中的节点顺序是任意排列的。

另请参阅：length()。

int QDomNamedNodeMap::length() const

返回映射中的节点数。

另请参阅：item()。

QDomNode QDomNamedNodeMap::namedItem(const QString &name) const

返回名为 name 的节点。

如果命名节点映射不包含此类节点，则返回一个空节点。一个节点的名称是由 QDomNode::nodeName() 返回的名称。

另请参阅：setNamedItem() 和 namedItemNS()。

QDomNode QDomNamedNodeMap::namedItemNS(const QString &nsURI, const QString &localName) const

返回与本地名称 localName 和命名空间 URI nsURI 相关的节点。

如果映射不包含此类节点，则返回一个空节点。

另请参阅 setNamedItemNS() 和 namedItem()。

QDomNode QDomNamedNodeMap::removeNamedItem(const QString &name)

从映射中移除名为 name 的节点。

该函数返回被移除的节点，或者如果映射中不包含名为 name 的节点，则返回一个空节点。

另请参阅 setNamedItem()，namedItem()，以及 removeNamedItemNS()。

QDomNode QDomNamedNodeMap::removeNamedItemNS(const QString &nsURI, const QString &localName)

从映射中移除本地名称为 localName 且命名空间 URI 为 nsURI 的节点。

如果映射中不包含具有指定本地名称和命名空间 URI 的节点，则该函数返回被移除的节点或一个空节点。

另请参阅 setNamedItemNS()，namedItemNS()，以及 removeNamedItem()。

QDomNode QDomNamedNodeMap::setNamedItem(const QDomNode &newNode)

将节点 newNode 插入到命名节点映射中。映射使用的名称是 newNode 的节点名称，该名称由 QDomNode::nodeName() 返回。

如果新节点替换了现有的节点，即映射包含具有相同名称的节点，则返回替换的节点。

另请参阅 namedItem()，removeNamedItem()，以及 setNamedItemNS()。

QDomNode QDomNamedNodeMap::setNamedItemNS(const QDomNode &newNode)

在映射中插入节点 newNode。如果映射中已存在具有相同命名空间 URI 和本地名称的节点，则它将被 newNode 替换。如果新节点替换了现有节点，则返回替换的节点。

另请参阅 namedItemNS()，removeNamedItemNS()，以及 setNamedItem()。

int QDomNamedNodeMap::size() const