內容

• 公共函數
• 詳細描述

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 .