![]() |
Qt 6.x
The Qt SDK
|
\reentrant More...
#include <qdom.h>
Public Member Functions | |
QDomNamedNodeMap () | |
Constructs an empty named node map. | |
QDomNamedNodeMap (const QDomNamedNodeMap &) | |
Constructs a copy of n. | |
QDomNamedNodeMap & | operator= (const QDomNamedNodeMap &) |
Assigns n to this named node map. | |
bool | operator== (const QDomNamedNodeMap &) const |
Returns true if n and this named node map are equal; otherwise returns false . | |
bool | operator!= (const QDomNamedNodeMap &) const |
Returns true if n and this named node map are not equal; otherwise returns false . | |
~QDomNamedNodeMap () | |
Destroys the object and frees its resources. | |
QDomNode | namedItem (const QString &name) const |
Returns the node called name. | |
QDomNode | setNamedItem (const QDomNode &newNode) |
Inserts the node newNode into the named node map. | |
QDomNode | removeNamedItem (const QString &name) |
Removes the node called name from the map. | |
QDomNode | item (int index) const |
Retrieves the node at position index. | |
QDomNode | namedItemNS (const QString &nsURI, const QString &localName) const |
Returns the node associated with the local name localName and the namespace URI nsURI. | |
QDomNode | setNamedItemNS (const QDomNode &newNode) |
Inserts the node newNode in the map. | |
QDomNode | removeNamedItemNS (const QString &nsURI, const QString &localName) |
Removes the node with the local name localName and the namespace URI nsURI from the map. | |
int | length () const |
Returns the number of nodes in the map. | |
int | count () const |
This function is provided for Qt API consistency. | |
int | size () const |
This function is provided for Qt API consistency. | |
bool | isEmpty () const |
Returns true if the map is empty; otherwise returns false . | |
bool | contains (const QString &name) const |
Returns true if the map contains a node called name; otherwise returns false . | |
Friends | |
class | QDomNode |
class | QDomDocumentType |
class | QDomElement |
\reentrant
The QDomNamedNodeMap class contains a collection of nodes that can be accessed by name.
\inmodule QtXml
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: \list 1
Items in the map are identified by the name which QDomNode::name() returns. Nodes are retrieved using namedItem(), namedItemNS() or item(). New nodes are inserted with setNamedItem() or setNamedItemNS() and removed with removeNamedItem() or removeNamedItemNS(). Use contains() to see if an item with the given name is in the named node map. The number of items is returned by length().
Terminology: in this class we use "item" and "node" interchangeably.
QDomNamedNodeMap::QDomNamedNodeMap | ( | ) |
QDomNamedNodeMap::QDomNamedNodeMap | ( | const QDomNamedNodeMap & | n | ) |
Constructs a copy of n.
Definition at line 2702 of file qdom.cpp.
References QBasicAtomicInteger< T >::ref(), and QDomNamedNodeMapPrivate::ref.
QDomNamedNodeMap::~QDomNamedNodeMap | ( | ) |
Destroys the object and frees its resources.
Definition at line 2750 of file qdom.cpp.
References QBasicAtomicInteger< T >::deref(), and QDomNamedNodeMapPrivate::ref.
bool QDomNamedNodeMap::contains | ( | const QString & | name | ) | const |
Returns true
if the map contains a node called name; otherwise returns false
.
{Note:} This function does not take the presence of namespaces into account. Use namedItemNS() to test whether the map contains a node with a specific namespace URI and name.
Definition at line 2911 of file qdom.cpp.
References IMPL.
|
inline |
|
inline |
QDomNode QDomNamedNodeMap::item | ( | int | index | ) | const |
int QDomNamedNodeMap::length | ( | ) | const |
Returns the node called name.
If the named node map does not contain such a node, a \l{QDomNode::isNull()}{null node} is returned. A node's name is the name returned by QDomNode::nodeName().
Returns the node associated with the local name localName and the namespace URI nsURI.
If the map does not contain such a node, a \l{QDomNode::isNull()}{null node} is returned.
bool QDomNamedNodeMap::operator!= | ( | const QDomNamedNodeMap & | n | ) | const |
QDomNamedNodeMap & QDomNamedNodeMap::operator= | ( | const QDomNamedNodeMap & | n | ) |
Assigns n to this named node map.
Definition at line 2719 of file qdom.cpp.
References QBasicAtomicInteger< T >::deref(), QBasicAtomicInteger< T >::ref(), and QDomNamedNodeMapPrivate::ref.
bool QDomNamedNodeMap::operator== | ( | const QDomNamedNodeMap & | n | ) | const |
Removes the node called name from the map.
The function returns the removed node or a \l{QDomNode::isNull()}{null node} if the map did not contain a node called name.
Removes the node with the local name localName and the namespace URI nsURI from the map.
The function returns the removed node or a \l{QDomNode::isNull()}{null node} if the map did not contain a node with the local name localName and the namespace URI nsURI.
Inserts the node newNode into the named node map.
The name used by the map is the node name of newNode as returned by QDomNode::nodeName().
If the new node replaces an existing node, i.e. the map contains a node with the same name, the replaced node is returned.
Definition at line 2782 of file qdom.cpp.
References IMPL, QDomNode::impl, and QDomNode.
Inserts the node newNode in the map.
If a node with the same namespace URI and the same local name already exists in the map, it is replaced by newNode. If the new node replaces an existing node, the replaced node is returned.
Definition at line 2844 of file qdom.cpp.
References IMPL, QDomNode::impl, and QDomNode.
|
inline |
|
friend |
|
friend |
|
friend |
Definition at line 385 of file qdom.h.
Referenced by item(), namedItem(), namedItemNS(), removeNamedItem(), removeNamedItemNS(), setNamedItem(), and setNamedItemNS().