All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class flybase.FastVector

java.lang.Object
   |
   +----flybase.FastVector

public class FastVector
extends java.lang.Object
implements java.lang.Cloneable, java.io.Serializable
FastVector class (a growable array).

Each vector tries to optimize storage management by maintaining a capacity and a capacityIncrement. The capacity is always at least as large as the vector size; it is usually larger because as elements are added to the vector, the vector's storage increases in chunks the size of capacityIncrement. Setting the capacity to what you want before inserting a large number of objects will reduce the amount of incremental reallocation. You can safely ignore the capacity and the vector will still work correctly.


Constructor Index

 o FastVector()
Constructs an empty vector.
 o FastVector(int)
Constructs an empty vector with the specified storage capacity.
 o FastVector(int, int)
Constructs an empty vector with the specified storage capacity and the specified capacityIncrement.
 o FastVector(Vector)

Method Index

 o addElement(Object)
Adds the specified object as the last element of the vector.
 o addItem(Object)
 o capacity()
Returns the current capacity of the vector.
 o clone()
Clones this vector.
 o contains(Object)
Returns true if the specified object is a value of the collection.
 o copyInto(Object[])
Copies the elements of this vector into the specified array.
 o elementAt(int)
Returns the element at the specified index.
 o elements()
Returns an enumeration of the elements.
 o ensureCapacity(int)
Ensures that the vector has at least the specified capacity.
 o firstElement()
Returns the first element of the sequence.
 o indexOf(Object)
Searches for the specified object, starting from the first position and returns an index to it.
 o indexOf(Object, int)
Searches for the specified object, starting at the specified position and returns an index to it.
 o insertElementAt(Object, int)
Inserts the specified object as an element at the specified index.
 o isEmpty()
Returns true if the collection contains no values.
 o itemAt(int)
 o lastElement()
Returns the last element of the sequence.
 o lastIndexOf(Object)
Searches backwards for the specified object, starting from the last position and returns an index to it.
 o lastIndexOf(Object, int)
Searches backwards for the specified object, starting from the specified position and returns an index to it.
 o removeAllElements()
Removes all elements of the vector.
 o removeElement(Object)
Removes the element from the vector.
 o removeElementAt(int)
Deletes the element at the specified index.
 o setElementAt(Object, int)
Sets the element at the specified index to be the specified object.
 o setSize(int)
Sets the size of the vector.
 o size()
Returns the number of elements in the vector.
 o toString()
Converts the vector to a string.
 o toVector()
dgg additions & synonyms
 o trimToSize()
Trims the vector's capacity down to size.

Constructors

 o FastVector
 public FastVector(int initialCapacity,
                   int capacityIncrement)
Constructs an empty vector with the specified storage capacity and the specified capacityIncrement.

Parameters:
initialCapacity - the initial storage capacity of the vector
capacityIncrement - how much to increase the element's size by.
 o FastVector
 public FastVector(int initialCapacity)
Constructs an empty vector with the specified storage capacity.

Parameters:
initialCapacity - the initial storage capacity of the vector
 o FastVector
 public FastVector()
Constructs an empty vector.

 o FastVector
 public FastVector(java.util.Vector jv)

Methods

 o toVector
 public java.util.Vector toVector()
dgg additions & synonyms

 o itemAt
 public java.lang.Object itemAt(int index)
 o addItem
 public void addItem(java.lang.Object item)
 o copyInto
 public final void copyInto(java.lang.Object anArray[])
Copies the elements of this vector into the specified array.

Parameters:
anArray - the array where elements get copied into
 o trimToSize
 public final void trimToSize()
Trims the vector's capacity down to size. Use this operation to minimize the storage of a vector. Subsequent insertions will cause reallocation.

 o ensureCapacity
 public final void ensureCapacity(int minCapacity)
Ensures that the vector has at least the specified capacity.

Parameters:
minCapacity - the desired minimum capacity
 o setSize
 public final void setSize(int newSize)
Sets the size of the vector. If the size shrinks, the extra elements (at the end of the vector) are lost; if the size increases, the new elements are set to null.

Parameters:
newSize - the new size of the vector
 o capacity
 public final int capacity()
Returns the current capacity of the vector.

 o size
 public final int size()
Returns the number of elements in the vector. Note that this is not the same as the vector's capacity.

 o isEmpty
 public final boolean isEmpty()
Returns true if the collection contains no values.

 o elements
 public final java.util.Enumeration elements()
Returns an enumeration of the elements. Use the Enumeration methods on the returned object to fetch the elements sequentially.

 o contains
 public final boolean contains(java.lang.Object elem)
Returns true if the specified object is a value of the collection.

Parameters:
elem - the desired element
 o indexOf
 public final int indexOf(java.lang.Object elem)
Searches for the specified object, starting from the first position and returns an index to it.

Parameters:
elem - the desired element
Returns:
the index of the element, or -1 if it was not found.
 o indexOf
 public final int indexOf(java.lang.Object elem,
                          int index)
Searches for the specified object, starting at the specified position and returns an index to it.

Parameters:
elem - the desired element
index - the index where to start searching
Returns:
the index of the element, or -1 if it was not found.
 o lastIndexOf
 public final int lastIndexOf(java.lang.Object elem)
Searches backwards for the specified object, starting from the last position and returns an index to it.

Parameters:
elem - the desired element
Returns:
the index of the element, or -1 if it was not found.
 o lastIndexOf
 public final int lastIndexOf(java.lang.Object elem,
                              int index)
Searches backwards for the specified object, starting from the specified position and returns an index to it.

Parameters:
elem - the desired element
index - the index where to start searching
Returns:
the index of the element, or -1 if it was not found.
 o elementAt
 public final java.lang.Object elementAt(int index)
Returns the element at the specified index.

Parameters:
index - the index of the desired element
Throws: ArrayIndexOutOfBoundsException
If an invalid index was given.
 o firstElement
 public final java.lang.Object firstElement()
Returns the first element of the sequence.

Throws: NoSuchElementException
If the sequence is empty.
 o lastElement
 public final java.lang.Object lastElement()
Returns the last element of the sequence.

Throws: NoSuchElementException
If the sequence is empty.
 o setElementAt
 public final void setElementAt(java.lang.Object obj,
                                int index)
Sets the element at the specified index to be the specified object. The previous element at that position is discarded.

Parameters:
obj - what the element is to be set to
index - the specified index
Throws: ArrayIndexOutOfBoundsException
If the index was invalid.
 o removeElementAt
 public final void removeElementAt(int index)
Deletes the element at the specified index. Elements with an index greater than the current index are moved down.

Parameters:
index - the element to remove
Throws: ArrayIndexOutOfBoundsException
If the index was invalid.
 o insertElementAt
 public final void insertElementAt(java.lang.Object obj,
                                   int index)
Inserts the specified object as an element at the specified index. Elements with an index greater or equal to the current index are shifted up.

Parameters:
obj - the element to insert
index - where to insert the new element
Throws: ArrayIndexOutOfBoundsException
If the index was invalid.
 o addElement
 public final void addElement(java.lang.Object obj)
Adds the specified object as the last element of the vector.

Parameters:
obj - the element to be added
 o removeElement
 public final boolean removeElement(java.lang.Object obj)
Removes the element from the vector. If the object occurs more than once, only the first is removed. If the object is not an element, returns false.

Parameters:
obj - the element to be removed
Returns:
true if the element was actually removed; false otherwise.
 o removeAllElements
 public final void removeAllElements()
Removes all elements of the vector. The vector becomes empty.

 o clone
 public java.lang.Object clone()
Clones this vector. The elements are not cloned.

Overrides:
clone in class java.lang.Object
 o toString
 public final java.lang.String toString()
Converts the vector to a string. Useful for debugging.

Overrides:
toString in class java.lang.Object

All Packages  Class Hierarchy  This Package  Previous  Next  Index