class Poco::XML::NodeList

Overview

The NodeList interface provides the abstraction of an ordered collection of nodes, without defining or constraining how this collection is implemented. More…

#include <NodeList.h>

class NodeList: public Poco::XML::DOMObject
{
public:
    // methods

    virtual
    Node*
    item(unsigned long index) const = 0;

    virtual
    unsigned long
    length() const = 0;
};

// direct descendants

class ChildNodesList;
class ElementsByTagNameList;
class ElementsByTagNameListNS;

Inherited Members

public:
    // methods

    void
    duplicate() const;

    void
    release() const;

    virtual
    void
    autoRelease() = 0;

Detailed Documentation

The NodeList interface provides the abstraction of an ordered collection of nodes, without defining or constraining how this collection is implemented.

The items in the NodeList are accessible via an integral index, starting from 0.

A NodeList returned from a method must be released with a call to release() when no longer needed.

Methods

virtual
Node*
item(unsigned long index) const = 0

Returns the index’th item in the collection.

If index is greater than or equal to the number of nodes in the list, this returns null.

virtual
unsigned long
length() const = 0

Returns the number of nodes in the list.

The range of valid node indices is 0 to length - 1 inclusive.