All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class COM.objectspace.jgl.ObjectIterator

java.lang.Object
   |
   +----COM.objectspace.jgl.ObjectIterator

public final class ObjectIterator
extends Object
implements RandomAccessIterator, Serializable

An ObjectIterator is a random access iterator that allows you to iterate through an array of Objects.

See Also:: RandomAccessIterator

ObjectIterator(): Construct myself to be an iterator with no associated data structure or position.
ObjectIterator(Object[]): Construct myself to be an iterator positioned at the first element of a specified array.
ObjectIterator(Object[], int): Construct myself to be positioned at a particular index of a specific array.
ObjectIterator(Object[], int, ObjectArray): Construct myself to be positioned at a particular index of a specific array.
ObjectIterator(Object[], ObjectArray): Construct myself to be an iterator positioned at the first element of a specified array.
ObjectIterator(ObjectIterator): Construct myself to be a copy of an existing iterator.

advance(): Advance by one.
advance(int): Advance by a specified amount.
atBegin(): Return true if I'm positioned at the first item of my input stream.
atEnd(): Return true if I'm positioned after the last item in my input stream.
begin(Object[]): Return an iterator positioned at the first element of a particular array.
begin(Object[], ObjectArray): Return an iterator positioned at the first element of a particular array.
clone(): Return a clone of myself.
distance(ForwardIterator): Return the distance from myself to another iterator.
end(Object[]): Return an iterator positioned immediately after the last element of a particular array.
end(Object[], ObjectArray): Return an iterator positioned immediately after the last element of a particular array.
equals(Object): Return true if a specified object is the same kind of iterator as me and is positioned at the same element.
equals(ObjectIterator): Return true if iterator is positioned at the same element as me.
get(): Return the object at my current position.
get(int): Return the object that is a specified distance from my current position.
getContainer(): Return null for my associated Container since none needs to exist.
hasMoreElements(): Return true if there are more elements in my input stream.
index(): Return my current index.
less(RandomAccessIterator): Return true if I'm before a specified iterator.
nextElement(): Return the next element in my input stream.
put(int, Object): Write an object at a specified distance from my current position.
put(Object): Set the object at my current position to a specified value.
retreat(): Retreat by one.
retreat(int): Retreat by a specified amount.

ObjectIterator

  public ObjectIterator()

Construct myself to be an iterator with no associated data structure or position.

ObjectIterator

  public ObjectIterator(ObjectIterator iterator)

Construct myself to be a copy of an existing iterator.

Parameters:: iterator - The iterator to copy.

ObjectIterator

  public ObjectIterator(Object array[])

Construct myself to be an iterator positioned at the first element of a specified array.

Parameters:: array - The array whose first element I will be positioned at.

ObjectIterator

  public ObjectIterator(Object array[],
                        ObjectArray objectArray)

Construct myself to be an iterator positioned at the first element of a specified array.

Parameters:: array - The array whose first element I will be positioned at.; objectArray - The container the iterator is associated with.

ObjectIterator

  public ObjectIterator(Object array[],
                        int index)

Construct myself to be positioned at a particular index of a specific array.

Parameters:: array - My associated array.; index - My associated index.

ObjectIterator

  public ObjectIterator(Object array[],
                        int index,
                        ObjectArray objectArray)

Construct myself to be positioned at a particular index of a specific array.

Parameters:: array - My associated array.; index - My associated index.; objectArray - The container the iterator is associated with.

begin

  public static ObjectIterator begin(Object array[])

Return an iterator positioned at the first element of a particular array.

Parameters:: array - The array whose first element I will be positioned at.

begin

  public static ObjectIterator begin(Object array[],
                                     ObjectArray objectArray)

Return an iterator positioned at the first element of a particular array.

Parameters:: array - The array whose first element I will be positioned at.; objectArray - The container the iterator is associated with.

end

  public static ObjectIterator end(Object array[])

Return an iterator positioned immediately after the last element of a particular array.

Parameters:: array - The array whose last element I will be positioned after.

end

  public static ObjectIterator end(Object array[],
                                   ObjectArray objectArray)

Return an iterator positioned immediately after the last element of a particular array.

Parameters:: array - The array whose last element I will be positioned after.; objectArray - The container the iterator is associated with.

index

  public int index()

Return my current index.

clone

  public Object clone()

Return a clone of myself.

Overrides:: clone in class Object

equals

  public boolean equals(Object object)

Return true if a specified object is the same kind of iterator as me and is positioned at the same element.

Parameters:: object - Any object.
Overrides:: equals in class Object

equals

  public boolean equals(ObjectIterator iterator)

Return true if iterator is positioned at the same element as me.

Parameters:: iterator - The iterator to compare myself against.

less

  public boolean less(RandomAccessIterator iterator)

Return true if I'm before a specified iterator.

Parameters:: iterator - The iterator to compare myself against.

get

  public Object get(int offset)

Return the object that is a specified distance from my current position.

Parameters:: offset - The offset from my current position.

put

  public void put(int offset,
                  Object object)

Write an object at a specified distance from my current position.

Parameters:: offset - The offset from my current position.; object - The object to write.

atBegin

  public boolean atBegin()

Return true if I'm positioned at the first item of my input stream.

atEnd

  public boolean atEnd()

Return true if I'm positioned after the last item in my input stream.

hasMoreElements

  public boolean hasMoreElements()

Return true if there are more elements in my input stream.

advance

  public void advance()

Advance by one.

advance

  public void advance(int n)

Advance by a specified amount.

Parameters:: n - The amount to advance.

retreat

  public void retreat()

Retreat by one.

retreat

  public void retreat(int n)

Retreat by a specified amount.

Parameters:: n - The amount to retreat.

nextElement

  public Object nextElement()

Return the next element in my input stream.

get

  public Object get()

Return the object at my current position.

put

  public void put(Object object)

Set the object at my current position to a specified value.

Parameters:: object - The object to be written at my current position.

distance

  public int distance(ForwardIterator iterator)

Return the distance from myself to another iterator. I should be before the specified iterator.

Parameters:: iterator - The iterator to compare myself against.

getContainer

  public Container getContainer()

Return null for my associated Container since none needs to exist.

All Packages  Class Hierarchy  This Package  Previous  Next  Index