XML DOM iterateNext() -metodi

Määritelmä ja käyttö

iterateNext() -metodi palauttaa seuraavan XPath-kyselyyn sopivan solmun.

Syntaksi:

iterateNext()

Palautusarvo

Palauttaa seuraavan sopivan solmun luettelosta, jos ei ole muita solmuja, palauttaa null.

Heittää poikkeuksen

Koska XPathResult palautetaan, jos dokumentti on muutettu, tämä metodi heittää poikkeuksen. Metodi heittää myös poikkeuksen, jos resultType ei ole UNORDERED_NODE_ITERATOR_TYPE tai ORDERED_NODE_ITERATOR_TYPE.

Selitys

iterateNext() -metodi palauttaa seuraavan XPath-kyselyyn sopivan solmun, jos kaikki sopivat solmut on palautettu, palauttaa null.

Tämä metodi käytetään, kun XPathResult on UNORDERED_NODE_ITERATOR_TYPE tai ORDERED_NODE_ITERATOR_TYPE. Jos tyyppi on järjestetty, solmut palautetaan niiden järjestyksessä, jossa ne ilmestyvät dokumentissa, muuten ne palautetaan satunnaisessa järjestyksessä.

Jos invalidIteratorState-ominaisuus on true, dokumentti on muutettu, ja tämä metodi heittää poikkeuksen.