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.