XML::DOM::NodeList (3)

Leading comments

Automatically generated by Pod::Man 2.28 (Pod::Simple 3.28)

Standard preamble:
========================================================================

(The comments found at the beginning of the groff file "man3/XML::DOM::NodeList.3pm".)

NAME

XML::DOM::NodeList - A node list as used by XML::DOM

DESCRIPTION

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.

Although the

spec states that all NodeLists are ``live'' in that they allways reflect changes to the tree, the NodeList returned by getElementsByTagName is not live in this implementation. See for details.

METHODS

item (index)

Returns the indexth item in the collection. If index is greater than or equal to the number of nodes in the list, this returns undef.

getLength

The number of nodes in the list. The range of valid child node indices is 0 to length-1 inclusive.

Additional methods not in the

DOM

Spec

dispose

Removes all circular references in this NodeList and its descendants so the objects can be claimed for garbage collection. The objects should not be used afterwards.