QDomNamedNodeMap(3qt)QDomNamedNodeMap(3qt)NAMEQDomNamedNodeMap - Collection of nodes that can be accessed by name
SYNOPSIS
All the functions in this class are reentrant when Qt is built with
thread support.</p>
#include <qdom.h>
Public Members
QDomNamedNodeMap ()
QDomNamedNodeMap ( const QDomNamedNodeMap & n )
QDomNamedNodeMap & operator= ( const QDomNamedNodeMap & n )
bool operator== ( const QDomNamedNodeMap & n ) const
bool operator!= ( const QDomNamedNodeMap & n ) const
~QDomNamedNodeMap ()
QDomNode namedItem ( const QString & name ) const
QDomNode setNamedItem ( const QDomNode & newNode )
QDomNode removeNamedItem ( const QString & name )
QDomNode item ( int index ) const
QDomNode namedItemNS ( const QString & nsURI, const QString & localName
) const
QDomNode setNamedItemNS ( const QDomNode & newNode )
QDomNode removeNamedItemNS ( const QString & nsURI, const QString &
localName )
uint length () const
uint count () const
bool contains ( const QString & name ) const
DESCRIPTION
The QDomNamedNodeMap class contains a collection of nodes that can be
accessed by name.
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: <ol type=1>
1 QDomDocumentType::entities() returns a map of all entities
described in the DTD.
2 QDomDocumentType::notations() returns a map of all notations
described in the DTD.
3 QDomNode::attributes() returns a map of all attributes of an
element.
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.
See also XML.
MEMBER FUNCTION DOCUMENTATIONQDomNamedNodeMap::QDomNamedNodeMap ()
Constructs an empty named node map.
QDomNamedNodeMap::QDomNamedNodeMap ( const QDomNamedNodeMap & n )
Constructs a copy of n.
QDomNamedNodeMap::~QDomNamedNodeMap ()
Destroys the object and frees its resources.
bool QDomNamedNodeMap::contains ( const QString & name ) const
Returns TRUE if the map contains a node called name; otherwise returns
FALSE.
uint QDomNamedNodeMap::count () const
Returns the number of nodes in the map.
This function is the same as length().
QDomNode QDomNamedNodeMap::item ( int index ) const
Retrieves the node at position index.
This can be used to iterate over the map. Note that the nodes in the
map are ordered arbitrarily.
See also length().
uint QDomNamedNodeMap::length () const
Returns the number of nodes in the map.
See also item().
QDomNode QDomNamedNodeMap::namedItem ( const QString & name ) const
Returns the node called name.
If the named node map does not contain such a node, a null node is
returned. A node's name is the name returned by QDomNode::nodeName().
See also setNamedItem() and namedItemNS().
QDomNode QDomNamedNodeMap::namedItemNS ( const QString & nsURI, const QString
& localName ) const
Returns the node associated with the local name localName and the
namespace URI nsURI.
If the map does not contain such a node, a null node is returned.
See also setNamedItemNS() and namedItem().
bool QDomNamedNodeMap::operator!= ( const QDomNamedNodeMap & n ) const
Returns TRUE if n and this named node map are not equal; otherwise
returns FALSE.
QDomNamedNodeMap & QDomNamedNodeMap::operator= ( const QDomNamedNodeMap & n )
Assigns n to this named node map.
bool QDomNamedNodeMap::operator== ( const QDomNamedNodeMap & n ) const
Returns TRUE if n and this named node map are equal; otherwise returns
FALSE.
QDomNode QDomNamedNodeMap::removeNamedItem ( const QString & name )
Removes the node called name from the map.
The function returns the removed node or a null node if the map did not
contain a node called name.
See also setNamedItem(), namedItem(), and removeNamedItemNS().
QDomNode QDomNamedNodeMap::removeNamedItemNS ( const QString & nsURI, const
QString & localName )
Removes the node with the local name localName and the namespace URI
nsURI from the map.
The function returns the removed node or a null node if the map did not
contain a node with the local name localName and the namespace URI
nsURI.
See also setNamedItemNS(), namedItemNS(), and removeNamedItem().
QDomNode QDomNamedNodeMap::setNamedItem ( const QDomNode & newNode )
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.
See also namedItem(), removeNamedItem(), and setNamedItemNS().
QDomNode QDomNamedNodeMap::setNamedItemNS ( const QDomNode & newNode )
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.
See also namedItemNS(), removeNamedItemNS(), and setNamedItem().
SEE ALSO
http://doc.trolltech.com/qdomnamednodemap.html
http://www.trolltech.com/faq/tech.html
COPYRIGHT
Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the
license file included in the distribution for a complete license
statement.
AUTHOR
Generated automatically from the source code.
BUGS
If you find a bug in Qt, please report it as described in
http://doc.trolltech.com/bughowto.html. Good bug reports help us to
help you. Thank you.
The definitive Qt documentation is provided in HTML format; it is
located at $QTDIR/doc/html and can be read using Qt Assistant or with a
web browser. This man page is provided as a convenience for those users
who prefer man pages, although this format is not officially supported
by Trolltech.
If you find errors in this manual page, please report them to qt-
bugs@trolltech.com. Please include the name of the manual page
(qdomnamednodemap.3qt) and the Qt version (3.3.8).
Trolltech AS 2 February 2007 QDomNamedNodeMap(3qt)