QDomNodeList(3qt)

📦 version 3.3.8b, in fedora 43, fedora 44

💖 QDomNodeList — the qdomnodelist.3qt era 💖

okay bestie, sit down, hydrate, because we're talking about QDomNodeList — a whole class that's just a list of QDomNode objects. yes, that's the whole vibe. a list. of nodes. iconic behavior honestly.

✨ NAME ✨

QDomNodeList — a List of QDomNode objects 🎀

✨ SYNOPSIS ✨

so like, heads up: all the functions in this class are reentrant when Qt is built with thread support.</p> (yes the stray </p> is canon, we don't question it, we respect it 🙈)

#include <qdom.h>

🌸 Public Members 🌸

QDomNodeList ()
QDomNodeList ( const QDomNodeList & n )
QDomNodeList & operator= ( const QDomNodeList & n )
bool operator== ( const QDomNodeList & n ) const
bool operator!= ( const QDomNodeList & n ) const
virtual ~QDomNodeList ()
virtual QDomNode item ( int index ) const
virtual uint length () const
uint count () const

✨ DESCRIPTION ✨

The QDomNodeList class is a list of QDomNode objects. that's it, that's the girl. 💅

You don't really ~make~ these yourself from scratch, no no — you obtain them from QDomDocument::elementsByTagName() and QDomNode::childNodes(). and here's the tea: the Document Object Model (DOM) requires these lists to be "live". meaning?? whenever you change the underlying document, the contents of the list get updated. the list is literally watching the document change in real time. main character energy fr fr. 👑

Wanna grab one specific node out of it? use item(). Wanna know how many you got? count() has you (and so does length(), they're the same bestie, twins 🫶).

For further information about the Document Object Model see http://www.w3.org/TR/REC-DOM-Level-1/ and http://www.w3.org/TR/DOM-Level-2-Core/. For a more general introduction of the DOM implementation see the QDomDocument documentation. (homework, but make it cute 📚✨)

See also: QDomNode::childNodes(), QDomDocument::elementsByTagName(), and XML.

✨ MEMBER FUNCTION DOCUMENTATION ✨

QDomNodeList::QDomNodeList ()

Creates an empty node list. nothing in it. a clean slate. a fresh start. we love a blank canvas moment 🦋

QDomNodeList::QDomNodeList ( const QDomNodeList & n )

Constructs a copy of n. 🪞

QDomNodeList::~QDomNodeList () [virtual]

Destroys the object and frees its resources. she's done, she's leaving, say bye 👋💜

uint QDomNodeList::count () const

Returns the number of nodes in the list. 🔢

This function is the same as length(). (twins. again. obsessed.)

QDomNode QDomNodeList::item ( int index ) const [virtual]

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). so like, out of bounds = you get nothing, not a crash, but a sad little nothing-node 😭

See also: count().

uint QDomNodeList::length () const [virtual]

Returns the number of nodes in the list. 🔢 (yes, same as count() — this function is the same as count(). they're the same. i said what i said.)

bool QDomNodeList::operator!= ( const QDomNodeList & n ) const

Returns TRUE the node list n and this node list are not equal; otherwise returns FALSE. (and yes, the sentence really does read like that in the source, we're keeping it verbatim, no notes 💀)

QDomNodeList & QDomNodeList::operator= ( const QDomNodeList & n )

Assigns n to this node list. ✍️

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

Returns TRUE if the node list n and this node list are equal; otherwise returns FALSE. ✅

✨ SEE ALSO ✨

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. (a robot did this, and honestly? it ate. 🤖✨)

✨ 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. 🫶 (genuinely, they mean it, good bug reports are a love language)

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. (so like, cute of them to include it, but don't come for them if the man page acts up 🙈)

If you find errors in this manual page, please report them to qt-bugs@trolltech.com. Please include the name of the manual page (qdomnodelist.3qt) and the Qt version (3.3.8). ⭐

💀 real talk bestie: that index >= length() thing is a null node, not an exception. check QDomNode::isNull() and stay safe out there. no cap.

and that's the page!! 🌈 this lil manual page came from Trolltech AS, dated 2 February 2007, and it lives under the name QDomNodeList(3qt) — so go forth, iterate your nodes, and slay. mwah. 💖✨🎀🦋🌸💅🫶👑

📦 where this page comes from