XML DOM iterateNext() metod

Definition och användning

iterateNext() metoden returnerar nästa nod som matchar en XPath-forespåring.

Syntaks:

iterateNext()

Returvärde

Returnerar nästa nod i matchningslistan, om det inte finns några andra noder, returneras null.

Kastar

Sedan XPathResult returneras, kastar denna metod ett undantag om dokumentet har ändrats. Metoden kastar också ett undantag om resultType inte är UNORDERED_NODE_ITERATOR_TYPE eller ORDERED_NODE_ITERATOR_TYPE.

Förklaring

iterateNext() metoden returnerar nästa nod som matchar XPath-forespåringen, om alla matchande noder redan har returnerats, returneras null.

Använd denna metod när XPathResult är UNORDERED_NODE_ITERATOR_TYPE eller ORDERED_NODE_ITERATOR_TYPE. Om typen är ordnad returneras noder i den ordning de uppstår i dokumentet, annars returneras de i en vilken ordning som helst.

Om invalidIteratorState-attributet är sant, har dokumentet redan ändrats, denna metod kastar ett undantag.