org.graalvm.polyglot.proxy

Interface ProxyIterator

All Superinterfaces:

Proxy

public interface ProxyIterator
extends Proxy

Interface to be implemented to mimic guest language iterators.

Since:

21.1

See Also:

Proxy, ProxyIterable

Method Summary

Modifier and Type	Method and Description
static ProxyIterator	from(Iterator<?> iterator) Creates a proxy iterator backed by a Java Iterator.
Object	getNext() Returns the next element in the iteration.
boolean	hasNext() Returns true if the iterator has more elements, else false.

Method Detail

hasNext

boolean hasNext()

Returns true if the iterator has more elements, else false. Multiple calls to the ProxyIterator.hasNext() might lead to different results if the underlying data structure is modified.

Since:

21.1

See Also:

ProxyIterator.getNext()

getNext

Object getNext()
        throws NoSuchElementException,
               UnsupportedOperationException

Returns the next element in the iteration. When the underlying data structure is modified the ProxyIterator.getNext() may throw the NoSuchElementException even when the ProxyIterator.hasNext() returned true.

Throws:

NoSuchElementException - if the iteration has no more elements, the ProxyIterator.hasNext() returns false.

UnsupportedOperationException - when the underlying iterator element exists but is not readable.

Since:

21.1

See Also:

ProxyIterator.hasNext()

from

static ProxyIterator from(Iterator<?> iterator)

Creates a proxy iterator backed by a Java Iterator. If the set values are host values then they will be unboxed. If the Java Iterator throws the ConcurrentModificationException the exception is translated into the host exception.

Since:

21.1