org.mases.jcobridge

Class JCObjectIterator

java.lang.Object

org.mases.jcobridge.JCHandler

org.mases.jcobridge.JCObjectIterator

All Implemented Interfaces:

Iterator

public final class JCObjectIterator
extends JCHandler
implements Iterator

JVM-side iterator for a CLR IEnumerable object.

Wraps a CLR enumerator obtained from a JCObject that represents a CLR collection or any type implementing IEnumerable. Each call to next() crosses the JNI boundary to advance the CLR enumerator and retrieve the next element, returned as a JCObject.

Instances are created internally by JCObject.iterator() and should not be constructed directly.

See also: JCOReflector for usage examples.

Since:

1.0.0.0

Author:

MASES S.R.L.

Method Summary

Modifier and Type	Method and Description
int	hashCode() Returns the hash code of the underlying CLR enumerator by delegating to the CLR GetHashCode method.
boolean	hasNext() Returns true if the CLR enumerator has more elements.
Object	next() Returns the next element in the CLR enumeration as a JCObject.
String	toString() Returns the string representation of the underlying CLR enumerator by delegating to the CLR ToString method.

Methods inherited from class org.mases.jcobridge.JCHandler

getReference

Methods inherited from class java.lang.Object

equals, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.Iterator

forEachRemaining, remove

Method Detail

hashCode

public int hashCode()

Returns the hash code of the underlying CLR enumerator by delegating to the CLR GetHashCode method.

Overrides:

hashCode in class Object

Returns:

the CLR hash code.

toString

public String toString()

Returns the string representation of the underlying CLR enumerator by delegating to the CLR ToString method.

Overrides:

toString in class Object

Returns:

the CLR string representation.

hasNext

public boolean hasNext()

Returns true if the CLR enumerator has more elements. Equivalent to calling MoveNext() on the CLR IEnumerator. Returns false if the native call fails.

Specified by:

hasNext in interface Iterator

Returns:

true if there are more elements to iterate.

next

public Object next()

Returns the next element in the CLR enumeration as a JCObject. Equivalent to reading Current from the CLR IEnumerator after a successful MoveNext().

Specified by:

next in interface Iterator

Returns:

the next element, wrapped as a JCObject.

Throws:

NoSuchElementException - if the enumeration has no more elements or if the native call fails.