All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class jgl.VectorIterator 

java.lang.Object
    |
    +----jgl.VectorIterator
public final class VectorIterator
extends Object
implements RandomAccessIterator
A VectorIterator is a random access iterator that allows you to iterate through the contents of a java.util.Vector.

Version:
JOS-FileSystem 4 Preview (25-Mar-98)
Author:
ObjectSpace, Inc.
See Also:
RandomAccessIterator

Constructor Index

o VectorIterator()
Construct myself to be an iterator with no associated data structure or position.
o VectorIterator(Vector, int)
Construct myself to be positioned at a particular index of a specific Vector.
o VectorIterator(Vector, int, VectorArray)
Construct myself to be positioned at a particular index of a specific Vector.
o VectorIterator(VectorIterator)
Construct myself to be a copy of an existing iterator.

Method Index

o advance()
Advance by one.
o advance(int)
Advance by a specified amount.
o atBegin()
Return true if I'm positioned at the first item of my input stream.
o atEnd()
Return true if I'm positioned after the last item in my input stream.
o begin(Vector)
Return an iterator positioned at the first element of a particular java.util.Vector.
o begin(Vector, VectorArray)
Return an iterator positioned at the first element of a particular java.util.Vector.
o clone()
Return a clone of myself.
o distance(ForwardIterator)
Return the distance from myself to another iterator.
o end(Vector)
Return an iterator positioned immediately after the last element of a particular java.util.Vector.
o end(Vector, VectorArray)
Return an iterator positioned immediately after the last element of a particular java.util.Vector.
o equals(Object)
Return true if a specified object is the same kind of iterator as me and is positioned at the same element.
o equals(VectorIterator)
Return true if iterator is positioned at the same element as me.
o get()
Return the object at my current position.
o get(int)
Return the object that is a specified distance from my current position.
o getContainer()
Return null for my associated Container since java.util.Vector isn't in the JGL hierarchy (but should be ;-)
o hasMoreElements()
Return true if there are more elements in my input stream.
o index()
Return my current index.
o less(RandomAccessIterator)
Return true if I'm before a specified iterator.
o nextElement()
Return the next element in my input stream.
o put(int, Object)
Write an object at a specified distance from my current position.
o put(Object)
Set the object at my current position to a specified value.
o retreat()
Retreat by one.
o retreat(int)
Retreat by a specified amount.

Constructors

o VectorIterator 
public VectorIterator()
Construct myself to be an iterator with no associated data structure or position.

o VectorIterator 
public VectorIterator(VectorIterator iterator)
Construct myself to be a copy of an existing iterator.

Parameters:
iterator - The iterator to copy.
o VectorIterator 
public VectorIterator(Vector vector,
                      int index)
Construct myself to be positioned at a particular index of a specific Vector.

Parameters:
vector - My associated Vector.
index - My associated index.
o VectorIterator 
public VectorIterator(Vector vector,
                      int index,
                      VectorArray vectorArray)
Construct myself to be positioned at a particular index of a specific Vector.

Parameters:
vector - My associated Vector.
index - My associated index.
vectorArray - The container the iterator is associated with.

Methods

o begin 
public static VectorIterator begin(Vector vector)
Return an iterator positioned at the first element of a particular java.util.Vector.

Parameters:
vector - The Vector whose first element I will be positioned at.
o begin 
public static VectorIterator begin(Vector vector,
                                   VectorArray vectorArray)
Return an iterator positioned at the first element of a particular java.util.Vector.

Parameters:
vector - The Vector whose first element I will be positioned at.
vectorArray - The container the iterator is associated with.
o end 
public static VectorIterator end(Vector vector)
Return an iterator positioned immediately after the last element of a particular java.util.Vector.

Parameters:
vector - The Vector whose last element I will be positioned after.
o end 
public static VectorIterator end(Vector vector,
                                 VectorArray vectorArray)
Return an iterator positioned immediately after the last element of a particular java.util.Vector.

Parameters:
vector - The Vector whose last element I will be positioned after.
vectorArray - The container the iterator is associated with.
o clone 
public Object clone()
Return a clone of myself.

Overrides:
clone in class Object
o 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
o equals 
public boolean equals(VectorIterator iterator)
Return true if iterator is positioned at the same element as me.

Parameters:
iterator - The iterator to compare myself against.
o less 
public boolean less(RandomAccessIterator iterator)
Return true if I'm before a specified iterator.

Parameters:
iterator - The iterator to compare myself against.
o 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.
Throws: ArrayIndexOutOfBoundsException
If the adjusted index is invalid.
o 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.
Throws: ArrayIndexOutOfBoundsException
If the adjusted index is invalid.
o atBegin 
public boolean atBegin()
Return true if I'm positioned at the first item of my input stream.

o atEnd 
public boolean atEnd()
Return true if I'm positioned after the last item in my input stream.

o hasMoreElements 
public boolean hasMoreElements()
Return true if there are more elements in my input stream.

o advance 
public void advance()
Advance by one.

o advance 
public void advance(int n)
Advance by a specified amount.

Parameters:
n - The amount to advance.
o retreat 
public void retreat()
Retreat by one.

o retreat 
public void retreat(int n)
Retreat by a specified amount.

Parameters:
n - The amount to retreat.
o nextElement 
public Object nextElement()
Return the next element in my input stream.

Throws: ArrayIndexOutOfBoundsException
If I'm positioned at an invalid index.
o get 
public Object get()
Return the object at my current position.

Throws: ArrayIndexOutOfBoundsException
If I'm positioned at an invalid index.
o 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.
Throws: ArrayIndexOutOfBoundsException
If I'm positioned at an invalid index.
o 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.
o index 
public int index()
Return my current index.

o getContainer 
public Container getContainer()
Return null for my associated Container since java.util.Vector isn't in the JGL hierarchy (but should be ;-) 

All Packages  Class Hierarchy  This Package  Previous  Next  Index