วิธี iterateNext() ของ XML DOM
การนิยามและการใช้งาน
วิธี iterateNext() คืนค่าตัวเลือกต่อไปที่ตรงกับคำถาม XPath
คำสั่งภาษา
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 แล้ว เอกสารได้ถูกแก้ไข วิธีนี้จะทิ้งข้อยกเว้น