XML DOM iterateNext() 方法

定义和用法

iterateNext() 方法返回和一个 XPath 查询匹配的下一个节点。

语法:

  1. iterateNext()

返回值

返回匹配节点列表中的下一个节点,如果没有其他节点,则为 null。

抛出

既然 XPathResult 被返回,如果文档已经修改了,这个方法会抛出异常。如果 resultType 不是 UNORDERED_NODE_ITERATOR_TYPE 或 ORDERED_NODE_ITERATOR_TYPE 的时候调用,方法也会抛出异常。

说明

iterateNext() 方法返回与 XPath 查询匹配的下一个节点,如果所有匹配节点都已经返回了,则为 null。

当 XPathResult 是 UNORDERED_NODE_ITERATOR_TYPE 或 ORDERED_NODE_ITERATOR_TYPE 的时候使用这个方法。如果类型是有序的,节点按照它们在文档中出现的顺序返回,否则,它们按照任意顺序返回。

如果 invalidIteratorState 属性为 true,文档已经被修改了,这个方法抛出异常。