Metoda iterateNext() DOM XML

Definicja i użycie

Metoda iterateNext() zwraca następny węzeł pasujący do zapytania XPath.

Gramatyka:

iterateNext()

Wartość zwracana

Zwraca następny węzeł z listy pasujących węzłów, jeśli nie ma innych węzłów, zwraca null.

Wyrzuć

Ponieważ XPathResult jest zwracany, jeśli dokument został zmodyfikowany, metoda ta wyrzuca wyjątek. Wywołanie metody również wyrzuca wyjątek, jeśli resultType nie jest UNORDERED_NODE_ITERATOR_TYPE lub ORDERED_NODE_ITERATOR_TYPE.

Wyjaśnienie

Metoda iterateNext() zwraca następny węzeł pasujący do zapytania XPath, jeśli wszystkie pasujące węzły zostały już zwrócone, zwraca null.

Używaj tej metody, gdy XPathResult jest UNORDERED_NODE_ITERATOR_TYPE lub ORDERED_NODE_ITERATOR_TYPE. Jeśli typ jest uporządkowany, węzły są zwracane w kolejności ich wystąpienia w dokumencie, w przeciwnym razie są zwracane w dowolnej kolejności.

Jeśli właściwość invalidIteratorState wynosi true, dokument został zmodyfikowany, metoda ta wyrzuca wyjątek.