class QDomNamedNodeMap#

PySide6.QtXml 中的 QDomNamedNodeMap 类包含了一组可以按名称访问的节点。更多...

简介#

方法#

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

注意

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

详细说明#

注意，QDomNamedNodeMap 未从 QDomNodeList 继承。QDomNamedNodeMap 不提供任何特定的节点排序。虽然可以按序号索引访问 DOMNamedNodeMap 中的节点，但这只是为了方便枚举 DOMNamedNodeMap 的内容，并不表示 DOM 指定了节点的排序。

QDomNamedNodeMap 被用于三个地方

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

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

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

映射中的项通过QDomNode::name()返回的名称进行标识。节点是通过使用namedItem()，namedItemNS()或item()检索的。新节点可通过使用setNamedItem()或setNamedItemNS()插入，并通过使用removeNamedItem()或removeNamedItemNS()删除。使用contains()来检查是否在命名节点映射中存在具有指定名称的项。通过length()返回项的数量。

术语：在这个类中，“项目”和“节点”是可以互换使用的。

__init__

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

__init__(arg__1)

参数:: arg__1 – QDomNamedNodeMap

构建n的副本。

contains(name)

参数:: name – str
返回类型:: bool

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

注意

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

count()

返回类型:: int

此函数提供是为了与Qt API保持一致性。它等同于length()。

isEmpty()#

返回类型:: bool

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

item(index)#

参数:: index – int
返回类型:: QDomNode

检索位于 index 位置的节点。

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

参考

length()

length()#

返回类型:: int

返回映射中的节点数量。

参考

item()

namedItem(name)#

参数:: name – str
返回类型:: QDomNode

返回名为 name 的节点。

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

参考

setNamedItem() namedItemNS()

namedItemNS(nsURI, localName)#

参数:

nsURI – str
localName – str

返回类型:

QDomNode

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

如果映射不包含这样的节点，则返回一个 null node。

参考

setNamedItemNS() namedItem()

__ne__(arg__1)#

参数:: arg__1 – QDomNamedNodeMap
返回类型:: bool

如果 n 和这个名为节点的映射不相等，则返回 true；否则返回 false。

__eq__(arg__1)#

参数:: arg__1 – QDomNamedNodeMap
返回类型:: bool

如果 n 和当前的命名节点映射相等，则返回 true；否则返回 false。

removeNamedItem(name)#

参数:: name – str
返回类型:: QDomNode

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

该函数返回移除的节点或 null 节点 ，如果映射不包含名为 name 的节点。

参考

setNamedItem() namedItem() removeNamedItemNS()

removeNamedItemNS(nsURI, localName)#

参数:

nsURI – str
localName – str

返回类型:

QDomNode

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

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

参考

setNamedItemNS() namedItemNS() removeNamedItem()

setNamedItem(newNode)#

参数:: newNode – QDomNode
返回类型:: QDomNode

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

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

参考

namedItem() removeNamedItem() setNamedItemNS()

setNamedItemNS(newNode)#

参数:: newNode – QDomNode
返回类型:: QDomNode

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

参考

namedItemNS() removeNamedItemNS() setNamedItem()

size()#

返回类型:: int

此函数提供是为了与Qt API保持一致性。它等同于length()。