DOMNodeList interface provides the abstraction of an ordered
* collection of nodes. DOMNodeLists are created by DOMDocument::getElementsByTagName(),
* DOMNode::getChildNodes(),
*
* The items in the DOMNodeList are accessible via an integral
* index, starting from 0.
*
* DOMNodeLists are "live", in that any changes to the document tree are immediately
* reflected in any DOMNodeLists that may have been created for that tree.
*/
class CDOM_EXPORT DOMNodeList {
protected:
// -----------------------------------------------------------------------
// Hidden constructors
// -----------------------------------------------------------------------
/** @name Hidden constructors */
//@{
DOMNodeList() {};
DOMNodeList(const DOMNodeList &) {};
DOMNodeList & operator = (const DOMNodeList &) {return *this;};
//@}
public:
// -----------------------------------------------------------------------
// All constructors are hidden, just the destructor is available
// -----------------------------------------------------------------------
/** @name Destructor */
//@{
/**
* Destructor
*
*/
virtual ~DOMNodeList() {};
//@}
// -----------------------------------------------------------------------
// Virtual DOMNodeList interface
// -----------------------------------------------------------------------
/** @name Functions introduced in DOM Level 1 */
//@{
// -----------------------------------------------------------------------
// Getter methods
// -----------------------------------------------------------------------
/**
* Returns the index item in the collection.
*
* If index is greater than or equal to the number of nodes in
* the list, this returns null.
*
* @param index Index into the collection.
* @return The node at the indexth position in the
* DOMNodeList, or null if that is not a valid
* index.
* @since DOM Level 1
*/
virtual DOMNode *item(XMLSize_t index) const = 0;
/**
* Returns the number of nodes in the list.
*
* The range of valid child node indices is 0 to length-1 inclusive.
* @since DOM Level 1
*/
virtual XMLSize_t getLength() const = 0;
//@}
};
XERCES_CPP_NAMESPACE_END
#endif