java.lang.Object
   |
   +--java.util.AbstractCollection
         |
         +--java.util.AbstractList
               |
               +--java.util.Vector

Deklaration

Beschreibung

Konstruktoren
public	Vector()
public	Vector(int initialCapacity)
public	Vector(Collection c)
public	Vector(int initialCapacity, int capacityIncrement)

Methoden
public synchronized void	add(int index, Object element)
public synchronized boolean	addAll(Collection c)
public synchronized boolean	addAll(int index, Collection c)
public synchronized void	addElement(Object obj)
public int	capacity()
public synchronized void	clear()
public synchronized Object	clone()
public boolean	contains(Object elem)
public synchronized void	copyInto(Object[] anArray)
public synchronized Object	elementAt(int index)
public synchronized Enumeration	elements()
public synchronized void	ensureCapacity(int minCapacity)
public synchronized Object	firstElement()
public synchronized Object	get(int index)
public boolean	hasMoreElements()
public int	indexOf(Object elem)
public synchronized int	indexOf(Object elem, int index)
public synchronized void	insertElementAt(Object obj, int index)
public boolean	isEmpty()
public synchronized Object	lastElement()
public int	lastIndexOf(Object elem)
public synchronized int	lastIndexOf(Object elem, int index)
public Object	nextElement()
public synchronized Object	remove(int index)
public synchronized void	removeAllElements()
public synchronized boolean	removeElement(Object obj)
public synchronized void	removeElementAt(int index)
public synchronized Object	set(int index, Object element)
public synchronized void	setElementAt(Object obj, int index)
public synchronized void	setSize(int newSize)
public int	size()
public Object[]	toArray()
public synchronized void	trimToSize()

Datenelemente im Detail

protected Object[] elementData

Speichert die Elemente des Vektors.

protected int elementCount

Enthält die Anzahl der momentan im Vektor enthaltenen Elemente.

protected int capacityIncrement

Falls durch das Hinzufügen eines neuen Elements eine Vergrößerung des Vektors erforderlich ist, wird die maximale Elementanzahl des Vektors um den Wert dieser Variablen erhöht. Wenn sie den Wert Null hat, wird die Größe des Vektors verdoppelt.

Konstruktoren im Detail

public Vector()

Erzeugt einen neuen Vektor mit einer voreingestellten Kapazität von zehn Elementen. capacityIncrement wird auf Null gesetzt, wodurch bei einer benötigten Vergrößerung die Kapazität verdoppelt wird.

public Vector(int initialCapacity)

Erzeugt einen neuen Vektor mit einer voreingestellten Kapazität von initialCapacity Elementen. capacityIncrement wird auf Null gesetzt, wodurch bei einer benötigten Vergrößerung die Kapazität verdoppelt wird.

public Vector(Collection c)     

Erzeugt einen neuen Vektor, der die Elemente aus der Collection c entsprechend der Reihenfolge ihres Iterators durch flaches Kopieren übernimmt.

public Vector(int initialCapacity, int capacityIncrement)

Erzeugt einen neuen Vektor mit einer voreingestellten Kapazität von initialCapacity Elementen. capacityIncrement wird auf den übergebenen Wert gesetzt, wodurch bei einer benötigten Vergrößerung die Kapazität um diese Anzahl an Elementen vergrößert wird.

Methoden im Detail

public synchronized void add(int index, Object element)     

Fügt das Element element an der Position index in den Vektor ein. index wird von Null an gezählt. Gegebenenfalls wird die Kapazität des Vektors erhöht.

Exception: ArrayIndexOutOfBoundsException

• Falls index negativ oder größer gleich der Anzahl der momentan enthaltenen Elemente ist.

public synchronized boolean addAll(Collection c)     

Hängt alle in der Collection c enthaltenen Elemente entsprechend der Reihenfolge ihres Iterators am Ende des Vektors an. Der Rückgabewert ist false, wenn c leer ist, sonst true.

public synchronized boolean addAll(int index, Collection c)     

Fügt alle in der Collection c enthaltenen Elemente entsprechend der Reihenfolge ihres Iterators an der Position index in den Vektor ein. Der Rückgabewert ist false, wenn c leer ist, sonst true.

Exception: ArrayIndexOutOfBoundsException

• Falls index negativ oder größer gleich der Anzahl der momentan enthaltenen Elemente ist.

public synchronized void addElement(Object obj)

Fügt das Element obj am Ende der vorhandenen Elemente an, wobei die Kapazität des Vektors gegebenenfalls erhöht wird.

public int capacity()

Liefert die Anzahl an Elementen, die der Vektor momentan ohne eine Vergrößerung speichern kann.

public synchronized void clear()     

Entfernt alle Elemente aus dem Vektor.

public synchronized Object clone()

Erzeugt ein neues Exemplar von Vector, dessen Elementliste eine identische Kopie dieses Exemplars ist. Die Elemente selbst werden hierbei nicht kopiert, d.h., beide Vektoren verweisen auf dieselben Objekte.

public boolean contains(Object elem)

Liefert true, wenn elem ein Element des Vektors ist, sonst false.

public synchronized void copyInto(Object[] anArray)

Kopiert die Elemente des Vektors in das übergebene Array. Es muß sichergestellt sein, daß anArray alle Elemente des Vektors fassen kann.

public synchronized Object elementAt(int index)

Liefert das Element des Vektors, das an der Position index steht.

Exception: ArrayIndexOutOfBoundsException

• Falls index negativ oder größer gleich der Anzahl der momentan enthaltenen Elemente ist.

public synchronized Enumeration elements()

Liefert die Elemente des Vektors in einem Exemplar von Enumeration zurück.

public synchronized void ensureCapacity(int minCapacity)

Paßt die Kapazität des Vektors so an, daß mindestens minCapacity Elemente gespeichert werden können. Hierbei wird zunächst geprüft, ob der Bedarf durch eine Erhöhung der Kapazität um capacityIncrement Elemente gedeckt werden kann. Sollte capacityIncrement Null sein, wird die Größe verdoppelt. Falls durch diese Maßnahmen die gewünschte Kapazität nicht erreicht wird, wird der Vektor auf minCapacity Elemente vergrößert. Die neuen Elemente werden mit null initialisiert. Falls minCapacity kleiner als die momentane Kapazität ist, bleibt diese Methode wirkungslos. Zur Verkleinerung eines Vektors sind die Methoden setSize() oder trimToSize() zu verwenden.

public synchronized Object firstElement()

Liefert das erste Element des Vektors zurück.

Exception: NoSuchElementException

• Falls der Vektor leer ist.

public synchronized Object get(int index)     

Liefert das Element des Vektors, das an der Position index steht.

Exception: ArrayIndexOutOfBoundsException

• Falls index negativ oder größer gleich der Anzahl der momentan enthaltenen Elemente ist.

public boolean hasMoreElements()

Liefert true, wenn noch weitere Elemente verfügbar sind, sonst false.

public int indexOf(Object elem)

Liefert den ersten Index, unter dem das Objekt elem im Vektor eingetragen ist. Falls elem kein Element des Vektors ist, wird der Wert -1 zurückgeliefert.

public synchronized int indexOf(Object elem, int index)

Liefert den ersten Index, unter dem das Objekt elem im Vektor eingetragen ist, wobei nur die Elemente ab dem Index index berücksichtigt werden. Falls elem nicht gefunden wird, wird der Wert -1 geliefert. Wenn index größer als die momentane Anzahl an gespeicherten Elementen ist, wird ebenfalls-1 zurückgegeben.

public synchronized void insertElementAt(Object obj, int index)

Fügt das Element obj an der Position index in den Vektor ein. index wird von Null an gezählt. Gegebenenfalls wird die Kapazität des Vektors erhöht.

Exception: ArrayIndexOutOfBoundsException

• Falls index negativ oder größer als die Anzahl der momentan enthaltenen Elemente ist.

public boolean isEmpty()

Liefert true, wenn der Vektor kein Element enthält, sonst false.

public synchronized Object lastElement()

Liefert das letzte Element des Vektors zurück.

Exception: NoSuchElementException

• Falls der Vektor leer ist.

public int lastIndexOf(Object elem)

Liefert den letzten Index, unter dem das Objekt elem im Vektor eingetragen ist. Falls elem kein Element des Vektors ist, wird der Wert -1 zurückgeliefert.

public synchronized int lastIndexOf(Object elem, int index)

Liefert den Index, unter dem das Objekt elem im Vektor eingetragen ist, wobei der Vektor ab dem Index index rückwärts durchsucht wird. Falls elem nicht gefunden wird, wird der Wert -1 zurückgeliefert.

public Object nextElement()

Liefert das nächste Element des Vektors.

Exception: NoSuchElementException

• Falls vor dem Aufruf bereits das letzte Element erreicht war.

public synchronized Object remove(int index)     

Entfernt das Element an der Position index und verschiebt die dahinterliegenden Elemente nach vorne.

Exception: ArrayIndexOutOfBoundsException

• Falls index negativ oder größer gleich der Anzahl der momentan enthaltenen Elemente ist.

public synchronized void removeAllElements()

Entfernt alle Elemente aus dem Vektor.

public synchronized boolean removeElement(Object obj)

Entfernt das erste Vorkommen von obj im Vektor und schiebt die dahinterliegenden Elemente nach vorne. Falls obj im Vektor gefunden wurde, wird true zurückgeliefert, sonst false.

public synchronized void removeElementAt(int index)

Entfernt das Element an der Position index und verschiebt die dahinterliegenden Elemente nach vorne.

Exception: ArrayIndexOutOfBoundsException

• Falls index negativ oder größer gleich der Anzahl der momentan enthaltenen Elemente ist.

public synchronized Object set(int index, Object element)     

Ersetzt das Element an der Position index durch element.

Exception: ArrayIndexOutOfBoundsException

• Falls index negativ oder größer gleich der Anzahl der momentan enthaltenen Elemente ist.

public synchronized void setElementAt(Object obj, int index)

Ersetzt das Element an der Position index durch obj.

Exception: ArrayIndexOutOfBoundsException

• Falls index negativ oder größer gleich der Anzahl der momentan enthaltenen Elemente ist.

public synchronized void setSize(int newSize)

Setzt die Größe des Vektors auf newSize Elemente. Wenn newSize größer als die momentane Kapazität ist, erfolgt eine Vergrößerung über einen Aufruf von ensureCapacity(). Wenn newSize dagegen kleiner als die momentane Kapazität ist, werden die überzähligen Elemente am Ende des Vektors entfernt.

public int size()

Liefert die momentane Anzahl der im Vektor gespeicherten Elemente zurück.

public Object[] toArray()     

Liefert ein neues Array, das die momentan im Vektor vorhandenen Elemente entsprechend ihrer Reihenfolge enthält.

public synchronized void trimToSize()

Paßt die Kapazität des Vektors an die Anzahl der momentan eingetragenen Elemente an. Mit dieser Methode kann der Speicherbedarf eines Vektors minimiert werden.