วิธี 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 แล้ว เอกสารได้ถูกแก้ไข วิธีนี้จะทิ้งข้อยกเว้น