QDomNamedNodeMap 类

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

头: #include <QDomNamedNodeMap>
qmake: QT += xml

注意: 此类的所有函数 可重入 .

公共函数

QDomNamedNodeMap (const QDomNamedNodeMap & n )
QDomNamedNodeMap ()
QDomNamedNodeMap & operator= (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
bool operator== (const QDomNamedNodeMap & n ) const

详细描述

Note that QDomNamedNodeMap does not inherit from QDomNodeList . QDomNamedNodeMaps do not provide any specific node ordering. Although nodes in a QDomNamedNodeMap may be accessed by an ordinal index, this is simply to allow a convenient enumeration of the contents of a QDomNamedNodeMap, and does not imply that the DOM specifies an ordering of the nodes.

The QDomNamedNodeMap is used in three places:

  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 (const QDomNamedNodeMap & n )

构造副本为 n .

QDomNamedNodeMap:: QDomNamedNodeMap ()

构造空命名节点映射。

QDomNamedNodeMap &QDomNamedNodeMap:: operator= (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 .

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

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