Weitere aktuelle Java-Titel finden Sie bei dpunkt.
 Inhaltsverzeichnis   Vorhergehendes Paket   Seite Zurück   Seite Vor   Nächstes Paket   Paketübersicht   Index

Interface java.util.List1.2

Deklaration

public interface List
extends java.util.Collection

Beschreibung

Dieses Interface definiert eine Schnittstelle für geordnete Kollektionen, die eine bestimmte Reihenfolge der Elemente garantieren und auch Duplikate erlauben. Weiterhin sind die Elemente über ihre Position zugreifbar.


 
Methoden
public booleanadd(Object o)
public voidadd(int index, Object element)
public booleanaddAll(Collection c)
public booleanaddAll(int index, Collection c)
public voidclear()
public booleancontains(Object o)
public booleancontainsAll(Collection c)
public booleanequals(Object o)
public Objectget(int index)
public inthashCode()
public intindexOf(Object o)
public booleanisEmpty()
public Iteratoriterator()
public intlastIndexOf(Object o)
public ListIteratorlistIterator()
public ListIteratorlistIterator(int index)
public Objectremove(int index)
public booleanremove(Object o)
public booleanremoveAll(Collection c)
public booleanretainAll(Collection c)
public Objectset(int index, Object element)
public intsize()
public ListsubList(int fromIndex, int toIndex)
public Object[]toArray()
public Object[]toArray(Object[] a)


 

Methoden im Detail

public boolean add(Object o)
Hängt das Objekt o am Ende der Liste an (optional). Der Rückgabewert ist grundsätzlich true.
public void add(int index, Object element)
Fügt das Element element an der Position index in die Liste ein.
Exception: IndexOutOfBoundsException
public boolean addAll(Collection c)
Hängt alle in der Kollektion c enthaltenen Elemente in der Reihenfolge ihres Iterators am Ende der Liste an (optional). Der Rückgabewert ist grundsätzlich true.
public 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 die Liste ein. Der Rückgabewert ist false, wenn c leer ist, sonst true.
Exception: IndexOutOfBoundsException
public void clear()
Entfernt alle Elemente aus der Liste (optional).
public boolean contains(Object o)
Liefert true, falls das Objekt o in der Liste enthalten ist, sonst false.
public boolean containsAll(Collection c)
Liefert true, falls alle in der Kollektion c vorhandenen Elemente in der Liste enthalten sind, sonst false.
public boolean equals(Object o)
Liefert true, falls o ein Exemplar von List ist, das dieselbe Anzahl von Elementen hat und die gleichen Elemente enthält. Die Gleichheit der Elemente wird mit deren equals() festgestellt.
public Object get(int index)
Liefert das Listenelement an der Position index zurück.
Exception: IndexOutOfBoundsException
public int hashCode()
Liefert einen Hashcode für das List-Objekt.
public int indexOf(Object o)
Liefert den ersten Index, unter dem das Objekt o in der Liste eingetragen ist. Falls o kein Element der Liste ist, wird der Wert -1 zurückgeliefert.
public boolean isEmpty()
Liefert true, falls die Liste leer ist, sonst false.
public Iterator iterator()
Liefert einen Iterator, mit dem die in der Liste enthaltenen Elemente von Anfang bis Ende abgerufen werden können.
public int lastIndexOf(Object o)
Liefert den letzten Index, unter dem das Objekt o in der Liste eingetragen ist. Falls o kein Element der Liste ist, wird der Wert -1 zurückgeliefert.
public ListIterator listIterator()
Liefert einen ListIterator, mit dem die in der Liste enthaltenen Elemente von Anfang bis Ende abgerufen werden können.
public ListIterator listIterator(int index)
Liefert einen ListIterator, mit dem die Listenelemente ab der Position index einschließlich bis zum Ende abgerufen werden können.
Exception: IndexOutOfBoundsException
public Object remove(int index)
Entfernt das Listenelement an der Position index.
Exception: IndexOutOfBoundsException
public boolean remove(Object o)
Entfernt das Objekt o aus der Liste (optional). Falls o mehrmals in der Liste enthalten ist, wird nur das erste Vorkommen entfernt. Der Rückgabewert ist true, falls das Objekt gefunden und entfernt wurde, sonst false.
public boolean removeAll(Collection c)
Entfernt alle Elemente, die sowohl in der Kollektion c als auch in der Liste enthalten sind (optional). Der Rückgabewert ist true, falls sich die Liste durch den Aufruf verändert hat, d. h., wenn es mindestens ein gemeinsames Element gibt, sonst false.
public boolean retainAll(Collection c)
Entfernt alle Elemente aus dieser Liste, die nicht in c enhalten sind. Der Rückgabewert ist true, falls sich die Liste durch den Aufruf verändert hat, d. h., wenn es mindestens ein Element gibt, das nicht in c enthalten ist, sonst false.
public Object set(int index, Object element)
Ersetzt das Listenelement an der Position index durch element.
Exception: IndexOutOfBoundsException
public int size()
Liefert die Anzahl der Elemente in der Liste zurück.
public List subList(int fromIndex, int toIndex)
Liefert einen Teilbreich der Liste zurück, der vom Element an der Position fromIndex einschließlich bis zur Position toIndex ausschließlich reicht. Die Objekte in der gelieferten Liste sind dieselben wie in dieser Liste. Änderungen an der zurückgegebenen Liste wirken sich auch auf diese Liste aus.
Exception: IndexOutOfBoundsException
public Object[] toArray()
Liefert ein neues Array, das die Elemente der Liste entsprechend ihrer Reihenfolge enthält.
public Object[] toArray(Object[] a)
Liefert ein Array, das diejenigen Elemente der Kollektion enthält, deren Typ dem Elementtyp von a entspricht. Falls a groß genug ist, um alle Elemente aufzunehmen, wird ein Verweis auf a geliefert, ansonsten wird ein neues Array erzeugt und ein Verweis darauf zurückgegeben. Wenn a mehr Elemente hat, als es Treffer gibt, wird das Element hiter dem letzten Treffer auf null gesetzt. Die Reihenfolge der Elemente im Array ergibt sich aus der Reihenfolge in der Liste.


 Inhaltsverzeichnis   Vorhergehendes Paket   Seite Zurück   Seite Vor   Nächstes Paket   Paketübersicht   Index

Copyright © 2002 dpunkt.Verlag, Heidelberg. Alle Rechte vorbehalten.