XML DOM iterateNext() metode

Definition og brug

iterateNext() metoden returnerer den næste node, der matcher en XPath-forespørgsel.

Syntaks:

iterateNext()

Returværdi

Returnerer den næste node i matchningslisten, hvis der ikke er flere noder, returneres null.

Kaster

Siden XPathResult returneres, vil denne metode kaste en undtagelse, hvis dokumentet allerede er blevet ændret. Metoden vil også kaste en undtagelse, hvis resultType ikke er UNORDERED_NODE_ITERATOR_TYPE eller ORDERED_NODE_ITERATOR_TYPE.

Beskrivelse

iterateNext() metoden returnerer den næste node, der matcher XPath-forespørgslen, hvis alle matchende noder allerede er blevet returneret, returneres null.

Brug denne metode, når XPathResult er UNORDERED_NODE_ITERATOR_TYPE eller ORDERED_NODE_ITERATOR_TYPE. Hvis typen er ordnet, returneres noderne i den rækkefølge, de optræder i dokumentet, ellers returneres de i en vilkårlig rækkefølge.

Hvis invalidIteratorState egenskaben er sand, er dokumentet blevet ændret, og denne metode kaster en undtagelse.