XML DOM iterateNext() Methode
Definition und Verwendung
Die Methode iterateNext() gibt den nächsten Knoten zurück, der mit einer XPath-Abfrage übereinstimmt.
Syntax:
iterateNext()
Rückgabewert
Gibt den nächsten Knoten der Liste der übereinstimmenden Knoten zurück, oder null, wenn keine anderen Knoten vorhanden sind.
Auswerfen
Da XPathResult zurückgegeben wird, wird eine Ausnahme ausgelöst, wenn das Dokument geändert wurde. Eine Ausnahme wird ebenfalls ausgelöst, wenn die Methode mit einem resultType, der nicht UNORDERED_NODE_ITERATOR_TYPE oder ORDERED_NODE_ITERATOR_TYPE ist, aufgerufen wird.
Erklärung
Die Methode iterateNext() gibt den nächsten Knoten zurück, der mit der XPath-Abfrage übereinstimmt, oder null, wenn alle übereinstimmenden Knoten bereits zurückgegeben wurden.
Verwende diese Methode, wenn XPathResult den Typ UNORDERED_NODE_ITERATOR_TYPE oder ORDERED_NODE_ITERATOR_TYPE hat. Wenn der Typ sortiert ist, werden die Knoten in der Reihenfolge ihrer im Dokument angegebenen Reihenfolge zurückgegeben, andernfalls werden sie in einer beliebigen Reihenfolge zurückgegeben.
Wenn das Attribut invalidIteratorState auf true gesetzt ist, wurde das Dokument geändert, und dieser Methodenaufruf wirft eine Ausnahme.