PySide6.QtXml.QDomNamedNodeMap¶

class QDomNamedNodeMap¶

QDomNamedNodeMap 类包含一个可以通过名称访问的节点集合。更多…

概要¶

方法¶

def __init__()
def contains()
def count()
def isEmpty()
def item()
def length()
def namedItem()
def namedItemNS()
def __ne__()
def __eq__()
def removeNamedItem()
def removeNamedItemNS()
def setNamedItem()
def setNamedItemNS()
def size()

注意

本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题，您也可以通过在我们的https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。

详细描述¶

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

QDomNamedNodeMap 在三个地方使用：

entities() 返回DTD中描述的所有实体的映射。

notations() 返回DTD中描述的所有符号的映射。

attributes() 返回元素的所有属性的映射。

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

术语：在本课程中，我们互换使用“item”和“node”。

__init__()¶

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

__init__(namedNodeMap)

Parameters:: namedNodeMap – QDomNamedNodeMap

构造一个namedNodeMap的副本。

contains(name)¶

Parameters:: name – str
Return type:: 布尔

如果地图包含一个名为 name 的节点，则返回 true；否则返回 false。

注意

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

count()¶

Return type:: 整数

此函数为Qt API一致性提供。它等同于length()。

isEmpty()¶

Return type:: 布尔

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

item(index)¶

Parameters:: 索引 – int
Return type:: QDomNode

检索位于位置 index 的节点。

这可以用来遍历地图。请注意，地图中的节点是任意排序的。

另请参阅

length()

length()¶

Return type:: 整数

返回地图中的节点数量。

另请参阅

item()

namedItem(name)¶

Parameters:: name – str
Return type:: QDomNode

返回名为 name 的节点。

如果命名的节点映射不包含这样的节点，将返回一个null node。节点的名称是由nodeName()返回的名称。

另请参阅

setNamedItem() namedItemNS()

namedItemNS(nsURI, localName)¶

Parameters:

nsURI – str
localName – str

Return type:

QDomNode

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

如果地图不包含这样的节点，将返回一个null node。

另请参阅

setNamedItemNS() namedItem()

__ne__(other)¶

Parameters:: 其他 – QDomNamedNodeMap
Return type:: 布尔

如果 other 和此命名节点映射不相等，则返回 true；否则返回 false。

__eq__(other)¶

Parameters:: 其他 – QDomNamedNodeMap
Return type:: 布尔

如果 other 和这个命名节点映射相等，则返回 true；否则返回 false。

removeNamedItem(name)¶

Parameters:: name – str
Return type:: QDomNode

从地图中移除名为 name 的节点。

该函数返回被移除的节点，如果地图中不包含名为name的节点，则返回null node。

另请参阅

setNamedItem() namedItem() removeNamedItemNS()

removeNamedItemNS(nsURI, localName)¶

Parameters:

nsURI – str
localName – str

Return type:

QDomNode

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

该函数返回被移除的节点，如果映射中不包含具有本地名称 localName 和命名空间 URI nsURI 的节点，则返回 null node。

另请参阅

setNamedItemNS() namedItemNS() removeNamedItem()

setNamedItem(newNode)¶

Parameters:: newNode – QDomNode
Return type:: QDomNode

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

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

另请参阅

namedItem() removeNamedItem() setNamedItemNS()

setNamedItemNS(newNode)¶

Parameters:: newNode – QDomNode
Return type:: QDomNode

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

另请参阅

namedItemNS() removeNamedItemNS() setNamedItem()

size()¶

Return type:: 整数

此函数为Qt API一致性提供。它等同于length()。