مетод iterateNext() XML DOM

تعریف و استفاده

مетод iterateNext() گره بعدی که با جستجوی XPath مطابقت دارد را بازگردانده.

جملات:

iterateNext()

مقدار بازگشتی

گره بعدی در لیست گره‌های همسان بازگردانده می‌شود، اگر گره دیگری نباشد، null را بازگردانده می‌کند.

انداختن استثنا

از آنجا که XPathResult بازگردانده شده است، اگر مستند تغییر کرده باشد، این روش یک استثنا می‌اندازد. همچنین، اگر method resultType UNORDERED_NODE_ITERATOR_TYPE یا ORDERED_NODE_ITERATOR_TYPE نباشد، روش نیز یک استثنا می‌اندازد.

توضیح

مетод iterateNext() گره بعدی که با جستجوی XPath مطابقت دارد را بازگردانده و اگر همه گره‌های همسان بازگردانده شده‌اند، null را بازگردانده می‌کند.

این روش را زمانی که XPathResult UNORDERED_NODE_ITERATOR_TYPE یا ORDERED_NODE_ITERATOR_TYPE باشد استفاده کنید. اگر نوع مرتب باشد، گره‌ها بر اساس ترتیب ظهور آن‌ها در مستند بازگردانده می‌شوند، در غیر این صورت، آن‌ها به ترتیب تصادفی بازگردانده می‌شوند.

اگر ویژگی invalidIteratorState در حالت true باشد، مستند تغییر کرده است و این روش یک استثنا می‌اندازد.