Méthode iterateNext() DOM XML
Définition et utilisation
La méthode iterateNext() renvoie le prochain nœud correspondant à une requête XPath.
Syntaxe :
iterateNext()
Valeur de retour
Renvoie le prochain nœud de la liste des nœuds correspondants, null s'il n'y a plus de nœuds.
Lève
Puisque XPathResult est retourné, si le document a été modifié, cette méthode lève une exception. Une exception est également levée si la méthode est appelée lorsque resultType n'est pas UNORDERED_NODE_ITERATOR_TYPE ou ORDERED_NODE_ITERATOR_TYPE.
Explication
La méthode iterateNext() renvoie le prochain nœud correspondant à la requête XPath, si tous les nœuds correspondants ont été renvoyés, il renvoie null.
Utilisez cette méthode lorsque XPathResult est de type UNORDERED_NODE_ITERATOR_TYPE ou ORDERED_NODE_ITERATOR_TYPE. Si le type est ordonné, les nœuds sont renvoyés dans l'ordre dans lequel ils apparaissent dans le document, sinon, ils sont renvoyés dans un ordre quelconque.
Si l'attribut invalidIteratorState est vrai, le document a été modifié, cette méthode lève une exception.