XML DOM iterateNext() yöntemi

Tanım ve kullanım

iterateNext() yöntemi, bir XPath sorgusuyla eşleşen bir sonraki düğümü döndürür.

Sözdizimi:

iterateNext()

Dönüş değeri

Eşleşen düğüm listesindeki bir sonraki düğümü döndürür, diğer düğümler yoksa null döndürür.

Fırlat

XPathResult döndürülüyorsa ve belge değiştirildiysa, bu yöntem bir istisna fırlatır. resultType UNORDERED_NODE_ITERATOR_TYPE veya ORDERED_NODE_ITERATOR_TYPE değilse çağrıldığında da yöntem bir istisna fırlatır.

Açıklama

iterateNext() yöntemi, XPath sorgusuyla eşleşen bir sonraki düğümü döndürür, tüm eşleşen düğümler döndürüldüğünde null döndürür.

XPathResult UNORDERED_NODE_ITERATOR_TYPE veya ORDERED_NODE_ITERATOR_TYPE olduğunda bu yöntem kullanılır. Eğer tür sıralıysa, düğümler belgede ortaya çıktıkları sırayla döndürülür, aksi takdirde rastgele bir sırayla döndürülür.

invalidIteratorState özelliği true olduğunda, belge değiştirildi, bu yöntem bir istisna fırlatır.