QDomNodeList Class Reference

\reentrant More...

#include <qdom.h>

Collaboration diagram for QDomNodeList:

Public Member Functions
	QDomNodeList ()
	Creates an empty node list.
	QDomNodeList (const QDomNodeList &nodeList)
	Constructs a copy of nodeList.
QDomNodeList &	operator= (const QDomNodeList &other)
	Assigns other to this node list.
bool	operator== (const QDomNodeList &other) const
	Returns true if the node list other and this node list are equal; otherwise returns false.
bool	operator!= (const QDomNodeList &other) const
	Returns true the node list other and this node list are not equal; otherwise returns false.
	~QDomNodeList ()
	Destroys the object and frees its resources.
QDomNode	item (int index) const
	Returns the node at position index.
QDomNode	at (int index) const
	This function is provided for Qt API consistency.
int	length () const
	Returns the number of nodes in the list.
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 list contains no items; otherwise returns false.

Friends
class	QDomNode
class	QDomElement
class	QDomDocument

Detailed Description

\reentrant

The QDomNodeList class is a list of QDomNode objects.

\inmodule QtXml

Lists can be obtained by QDomDocument::elementsByTagName() and QDomNode::childNodes(). The Document Object Model (DOM) requires these lists to be "live": whenever you change the underlying document, the contents of the list will get updated.

You can get a particular node from the list with item(). The number of items in the list is returned by length().

For further information about the Document Object Model see \l{http://www.w3.org/TR/REC-DOM-Level-1/}{Level 1} and \l{http://www.w3.org/TR/DOM-Level-2-Core/}{Level 2 Core}. For a more general introduction of the DOM implementation see the QDomDocument documentation.

See also

QDomNode::childNodes(), QDomDocument::elementsByTagName()

Definition at line 213 of file qdom.h.

Constructor & Destructor Documentation

QDomNodeList() [1/2]

QDomNodeList::QDomNodeList

(

)

Creates an empty node list.

Definition at line 768 of file qdom.cpp.

QDomNodeList() [2/2]

QDomNodeList::QDomNodeList

(

const QDomNodeList &

nodeList

)

Constructs a copy of nodeList.

Definition at line 781 of file qdom.cpp.

References QBasicAtomicInteger< T >::ref(), and QDomNodeListPrivate::ref.

Here is the call graph for this function:

~QDomNodeList()

QDomNodeList::~QDomNodeList

(

)

Destroys the object and frees its resources.

Definition at line 826 of file qdom.cpp.

References QBasicAtomicInteger< T >::deref(), and QDomNodeListPrivate::ref.

Here is the call graph for this function:

Member Function Documentation

at()

QDomNode QDomNodeList::at ( int index ) const

inline

This function is provided for Qt API consistency.

It is equivalent to item().

If index is negative or if index >= length() then a null node is returned (i.e. a node for which QDomNode::isNull() returns true).

Definition at line 225 of file qdom.h.

References item.

count()

int QDomNodeList::count ( ) const

inline

This function is provided for Qt API consistency.

It is equivalent to length().

Definition at line 229 of file qdom.h.

isEmpty()

bool QDomNodeList::isEmpty ( ) const

inline

Returns true if the list contains no items; otherwise returns false.

This function is provided for Qt API consistency.

Definition at line 231 of file qdom.h.

item()

QDomNode QDomNodeList::item

(

int

index

)

const

Returns the node at position index.

If index is negative or if index >= length() then a null node is returned (i.e. a node for which QDomNode::isNull() returns true).

See also

length()

Definition at line 841 of file qdom.cpp.

References QDomNodeListPrivate::item(), and QDomNode.

Here is the call graph for this function:

length()

int QDomNodeList::length

(

)

const

Returns the number of nodes in the list.

Definition at line 852 of file qdom.cpp.

References QDomNodeListPrivate::length().

Here is the call graph for this function:

operator!=()

bool QDomNodeList::operator!=

(

const QDomNodeList &

other

)

const

Returns true the node list other and this node list are not equal; otherwise returns false.

Definition at line 818 of file qdom.cpp.

References operator==(), and other().

Here is the call graph for this function:

operator=()

QDomNodeList & QDomNodeList::operator=

(

const QDomNodeList &

other

)

Assigns other to this node list.

Definition at line 791 of file qdom.cpp.

References QBasicAtomicInteger< T >::deref(), other(), and QDomNodeListPrivate::ref.

Here is the call graph for this function:

operator==()

bool QDomNodeList::operator==

(

const QDomNodeList &

other

)

const

Returns true if the node list other and this node list are equal; otherwise returns false.

Definition at line 805 of file qdom.cpp.

References other().

Referenced by operator!=().

Here is the call graph for this function:

Here is the caller graph for this function:

size()

int QDomNodeList::size ( ) const

inline

This function is provided for Qt API consistency.

It is equivalent to length().

Definition at line 230 of file qdom.h.

Friends And Related Symbol Documentation

QDomDocument

friend class QDomDocument

friend

Definition at line 239 of file qdom.h.

QDomElement

friend class QDomElement

friend

Definition at line 238 of file qdom.h.

QDomNode

friend class QDomNode

friend

Definition at line 237 of file qdom.h.

Referenced by item().

---

The documentation for this class was generated from the following files:

• qtbase/src/xml/dom/qdom.h (de0230467c1f658232b101a99e62d68992173592)
• qtbase/src/xml/dom/qdom.cpp (b1e8287b8db5463f9a933302a27671b2b0ca1fa5)