内容

• 公共函数
• 详细描述

QDomNamedNodeMap 类

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

头：	#include <QDomNamedNodeMap>
qmake:	QT += 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

详细描述

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

注意， QDomNamedNodeMap 并非继承自 QDomNodeList 。QDomNamedNodeMap 不提供任何特定节点排序。尽管节点在 QDomNamedNodeMap 可以按序数索引访问，这仅仅允许内容方便枚举对于 QDomNamedNodeMap ，且并未暗示 DOM 会指定节点排序。

The QDomNamedNodeMap 用于 3 个地方：

1. QDomDocumentType::entities () 返回 DTD 中描述的所有实体的映射。
2. QDomDocumentType::notations () 返回 DTD 中描述的所有表示法的映射。
3. QDomNode::attributes () 返回元素所有属性的映射。

映射中的项由 QDomNode:name() 返回的名称进行标识。节点的检索是使用 namedItem (), namedItemNS () 或 item ()。新节点的插入是采用 setNamedItem () 或 setNamedItemNS () 和被移除采用 removeNamedItem () 或 removeNamedItemNS ()。使用 contains () 以查看具有给定名称的项是否在命名节点映射中。项数的返回是通过 length ().

术语：此类中 item 和 node 的使用可互换。

成员函数文档编制

QDomNamedNodeMap:: QDomNamedNodeMap ()

构造空命名节点映射。

QDomNamedNodeMap:: QDomNamedNodeMap (const QDomNamedNodeMap & n )

构造副本为 n .

QDomNamedNodeMap:: ~QDomNamedNodeMap ()

销毁对象并释放其资源。

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

返回 true 若映射包含节点称为 name ；否则返回 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 .

若命名节点映射不包含这样的节点， null 节点 被返回。节点的名称返回通过 QDomNode::nodeName ().

另请参阅 setNamedItem () 和 namedItemNS ().

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

返回节点关联本地名称 localName 和名称空间 URI nsURI .

若映射不包含这样的节点， null 节点 被返回。

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

QDomNode QDomNamedNodeMap:: removeNamedItem (const QString & name )

移除节点称为 name 从映射。

函数返回被移除节点或 null 节点 若映射并未包含节点称为 name .

另请参阅 setNamedItem (), namedItem ()，和 removeNamedItemNS ().

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

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

函数返回被移除节点或 null 节点 若映射并未包含节点具有本地名称 localName 和名称空间 URI nsURI .

另请参阅 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

提供此函数是为 Qt API 一致性。它相当于 length ().

bool QDomNamedNodeMap:: operator!= (const QDomNamedNodeMap & n ) const

返回 true if n 和此命名节点映射不相等；否则返回 false .

QDomNamedNodeMap &QDomNamedNodeMap:: operator= (const QDomNamedNodeMap & n )

赋值 n 到此命名节点映射。

bool QDomNamedNodeMap:: operator== (const QDomNamedNodeMap & n ) const

返回 true if n 和此命名节点映射相等；否则返回 false .