طريقة iterateNext() لـ DOM XML

دليل موضوع XPathResult

التعريف والاستخدام

يبدأ 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، تم تعديل المستند، ويجب أن يلقي هذا الطريقة استثناء.

دليل موضوع XPathResult