diff -r 000000000000 -r 02cd6b52f378 dummy_foundation/lib/XML/DOM/NodeList.pod --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/dummy_foundation/lib/XML/DOM/NodeList.pod Thu May 28 10:10:03 2009 +0100 @@ -0,0 +1,46 @@ +=head1 NAME + +XML::DOM::NodeList - A node list as used by XML::DOM + +=head1 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 DOM spec states that all NodeLists are "live" in that they +allways reflect changes to the DOM tree, the NodeList returned by +getElementsByTagName is not live in this implementation. See L +for details. + +=head2 METHODS + +=over 4 + +=item 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. + +=item getLength + +The number of nodes in the list. The range of valid child +node indices is 0 to length-1 inclusive. + +=back + +=head2 Additional methods not in the DOM Spec + +=over 4 + +=item 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. + +=back