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.