QDomNodeList Class Reference

\reentrant More...

#include <qdom.h>

Collaboration diagram for QDomNodeList:

Public Member Functions
	QDomNodeList ()
	Creates an empty node list.
	QDomNodeList (const QDomNodeList &)
	Constructs a copy of n.
QDomNodeList &	operator= (const QDomNodeList &)
	Assigns n to this node list.
bool	operator== (const QDomNodeList &) const
	Returns true if the node list n and this node list are equal; otherwise returns false.
bool	operator!= (const QDomNodeList &) const
	Returns true the node list n 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 210 of file qdom.h.

Constructor & Destructor Documentation

QDomNodeList() [1/2]

QDomNodeList::QDomNodeList

(

)

Creates an empty node list.

Definition at line 769 of file qdom.cpp.

QDomNodeList() [2/2]

QDomNodeList::QDomNodeList

(

const QDomNodeList &

n

)

Constructs a copy of n.

Definition at line 782 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 827 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 222 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 226 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 228 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 842 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 853 of file qdom.cpp.

References QDomNodeListPrivate::length().

Here is the call graph for this function:

operator!=()

bool QDomNodeList::operator!=

(

const QDomNodeList &

n

)

const

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

Definition at line 819 of file qdom.cpp.

References operator==().

Here is the call graph for this function:

operator=()

QDomNodeList & QDomNodeList::operator=

(

const QDomNodeList &

n

)

Assigns n to this node list.

Definition at line 792 of file qdom.cpp.

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

Here is the call graph for this function:

operator==()

bool QDomNodeList::operator==

(

const QDomNodeList &

n

)

const

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

Definition at line 806 of file qdom.cpp.

Referenced by operator!=().

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 227 of file qdom.h.

Friends And Related Symbol Documentation

QDomDocument

friend class QDomDocument

friend

Definition at line 236 of file qdom.h.

QDomElement

friend class QDomElement

friend

Definition at line 235 of file qdom.h.

QDomNode

friend class QDomNode

friend

Definition at line 234 of file qdom.h.

Referenced by item().

---

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

• qtbase/src/xml/dom/qdom.h
• qtbase/src/xml/dom/qdom.cpp