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

Klasse java.util.Collections1.2

java.lang.Object
   |
   +--java.util.Collections

Deklaration

public class Collections
extends java.lang.Object

Beschreibung

Diese Klasse stellt eine Reihe von statischen Hilfsfunktionen für Kollektionen zur Verfügung.


 
Datenelemente
public static final ListEMPTY_LIST
public final static MapEMPTY_MAP     [1.3]
public static final SetEMPTY_SET
 
Methoden
public static intbinarySearch(List list, Object key)
public static intbinarySearch(List list, Object key, Comparator c)
public static voidcopy(List dest, List src)
public static Enumerationenumeration(Collection c)
public static voidfill(List list, Object o)
public static intindexOfSubList(List source, List target)     [1.4]
public static intlastIndexOfSubList(List source, List target)     [1.4]
public static ArrayListlist(Enumeration e)     [1.4]
public static Objectmax(Collection coll)
public static Objectmax(Collection coll, Comparator comp)
public static Objectmin(Collection coll)
public static Objectmin(Collection coll, Comparator comp)
public static ListnCopies(final int n, final Object o)
public static booleanreplaceAll(List list, Object oldVal, Object newVal)     [1.4]
public static voidreverse(List list)
public static ComparatorreverseOrder()
public static voidrotate(List list, int distance)     [1.4]
public static voidshuffle(List list)
public static voidshuffle(List list, Random r)
public static Setsingleton(Object o)
public static ListsingletonList(Object o)     [1.3]
public static MapsingletonMap(Object key, Object value)     [1.3]
public static voidsort(List list)
public static voidsort(List list, Comparator c)
public static voidswap(List list, int i, int j)     [1.4]
public static CollectionsynchronizedCollection(Collection c)
public static ListsynchronizedList(List list)
public static MapsynchronizedMap(Map m)
public static SetsynchronizedSet(Set s)
public static SortedMapsynchronizedSortedMap(SortedMap m)
public static SortedSetsynchronizedSortedSet(SortedSet s)
public static CollectionunmodifiableCollection(Collection c)
public static ListunmodifiableList(List list)
public static MapunmodifiableMap(Map m)
public static SetunmodifiableSet(Set s)
public static SortedMapunmodifiableSortedMap(SortedMap m)
public static SetunmodifiableSortedSet(SortedSet s)


 

Datenelemente im Detail

public static final List EMPTY_LIST
Eine leere und unveränderbare List.
public final static Map EMPTY_MAP     [1.3]
Eine leere und unveränderbare Map.
public static final Set EMPTY_SET
Eine leere und unveränderbare Set.

 

Methoden im Detail

public static int binarySearch(List list, Object key)
Sucht in der Liste list ein Objekt, das im Sinne der natürlichen Ordnung gleich key ist. Als Voraussetzung müssen die Klassen aller enthaltenen Objekte das Interface Comparable implementieren, und die Liste muß bereits sortiert sein. Falls es ein Element mit dieser Eigenschaft gibt, wird der zugehörige Index zurückgeliefert. Ansonsten wird ein negativer Wert geliefert, dessen Betrag+1 dem Index entspricht, an dem key eingefügt werden müßte.
public static int binarySearch(List list, Object key, Comparator c)
Sucht in der Liste list ein Objekt, das im Sinne der durch c gegebenen Ordnung gleich key ist. Als Voraussetzung muß die Liste bereits sortiert sein. Falls es ein Element mit dieser Eigenschaft gibt, wird der zugehörige Index zurückgeliefert. Ansonsten wird ein negativer Wert geliefert, dessen Betrag+1 dem Index entspricht, an dem key eingefügt werden müßte.
public static void copy(List dest, List src)
Ersetzt die in dest enthaltenen Elemente durch die aus src.
Exception: IndexOutOfBoundsException
public static Enumeration enumeration(Collection c)
Bietet die Möglichkeit, auf die Kollektion c wie auf eine Enumeration zuzugreifen.
public static void fill(List list, Object o)
Ersetzt alle Elemente von list durch Verweise auf o.
public static int indexOfSubList(List source, List target)     [1.4]
Liefert die Startposition in target, ab der die Inhalte in source enthalten sind. Wenn die source keine Teilliste von target ist, wird -1 zurückgeliefert.
public static int lastIndexOfSubList(List source, List target)     [1.4]
Liefert die Endeposition in target, ab der die Inhalte in source enthalten sind. Wenn die source keine Teilliste von target ist, wird -1 zurückgeliefert.
public static ArrayList list(Enumeration e)     [1.4]
Liefert ein ArrayList-Exemplar, das die Elemente enthählt, die durch das übergebene Enumeration-Exemplar zurückgeliefert werden.
public static Object max(Collection coll)
Liefert das im Sinne der natürlichen Ordnung größte Element der Kollektion coll zurück. Als Voraussetzung müssen die Klassen aller enthaltenen Objekte das Interface Comparable implementieren.
public static Object max(Collection coll, Comparator comp)
Liefert das im Sinne der durch comp gegebenen Ordnung größte Element der Kollektion coll zurück.
public static Object min(Collection coll)
Liefert das im Sinne der natürlichen Ordnung kleinste Element der Kollektion coll zurück. Als Voraussetzung müssen die Klassen aller enthaltenen Objekte das Interface Comparable implementieren.
public static Object min(Collection coll, Comparator comp)
Liefert das im Sinne der durch comp gegebenen Ordnung kleinste Element der Kollektion coll zurück.
public static List nCopies(final int n, final Object o)
Liefert eine neue List, die n Referenzen auf das Objekt o enthält.
public static boolean replaceAll(List list, Object oldVal, Object newVal)     [1.4]
Ersetzt alle Elemente in list, die newVal als Wert haben mit oldVal.
public static void reverse(List list)
Kehrt die Reihenfolge der Elemente in der Liste l um.
public static Comparator reverseOrder()
Liefert ein Comparator Objekt, das gemäß der umgekehrten natürlichen Ordnung der Elemente sortiert.
public static void rotate(List list, int distance)     [1.4]
Rotiert die Elemente in der Liste list um diatance Elemente. Dabei wird zum aktuellen Index jedes Elements distance dazuadidiert. Wenn der daraus resultierende Wert größer als die Anzahl an Elementen ist, wird die Anzahl an Elementen subtrahiert.
public static void shuffle(List list)
Vertauscht die in list enthaltenen Elemente zufällig. Alle möglichen Permutationen sind gleich wahrscheinlich.
public static void shuffle(List list, Random r)
Vertauscht die in list enthaltenen Elemente zufällig, wobei r zu Ermittlung der benötigten Zufallszahlen verwendet.
public static Set singleton(Object o)
Liefert eine neue, unveränderbare Set, die nur das Element o enthält.
public static List singletonList(Object o)     [1.3]
Liefert eine unveränderte List, die nur das übergebene Objekt enthält.
public static Map singletonMap(Object key, Object value)     [1.3]
Liefert eine unveränderte Map, die nur das übergebene Objekt enthält.
public static void sort(List list)
Sortiert die übergebene Liste aufsteigend anhand der natürlichen Ordnung der enthaltenen Objekte. Als Voraussetzung müssen die Klassen aller enthaltenen Objekte das Interface Comparable implementieren.
public static void sort(List list, Comparator c)
Sortiert die übergebene Liste aufsteigend anhand der durch c gegebenen Ordnung.
public static void swap(List list, int i, int j)     [1.4]
Vertauscht zwei Elemente in list.
public static Collection synchronizedCollection(Collection c)
Liefert eine neue Collection mit den Elementen aus c, die sich zum parallelen Zugriff von mehreren Threads eignet. Alle Zugriffe müssen hierzu in synchronized-Blöcke eingefaßt sein, die auf das gelieferte Objekt synchronisiert sind.
public static List synchronizedList(List list)
Liefert eine neue List mit den Elementen aus list, die sich zum parallelen Zugriff von mehreren Threads eignet. Alle Zugriffe müssen hierzu in synchronized-Blöcke eingefaßt sein, die auf das gelieferte Objekt synchronisiert sind.
public static Map synchronizedMap(Map m)
Liefert eine neue Map mit den Elementen aus m, die sich zum parallelen Zugriff von mehreren Threads eignet. Alle Zugriffe müssen hierzu in synchronized-Blöcke eingefaßt sein, die auf das gelieferte Objekt synchronisiert sind.
public static Set synchronizedSet(Set s)
Liefert eine neue Set mit den Elementen aus s, die sich zum parallelen Zugriff von mehreren Threads eignet. Alle Zugriffe müssen hierzu in synchronized-Blöcke eingefaßt sein, die auf das gelieferte Objekt synchronisiert sind.
public static SortedMap synchronizedSortedMap(SortedMap m)
Liefert eine neue SortedMap mit den Elementen aus m, die sich zum parallelen Zugriff von mehreren Threads eignet. Alle Zugriffe müssen hierzu in synchronized-Blöcke eingefaßt sein, die auf das gelieferte Objekt synchronisiert sind.
public static SortedSet synchronizedSortedSet(SortedSet s)
Liefert eine neue SortedSet mit den Elementen aus s, die sich zum parallelen Zugriff von mehreren Threads eignet. Alle Zugriffe müssen hierzu in synchronized-Blöcke eingefaßt sein, die auf das gelieferte Objekt synchronisiert sind.
public static Collection unmodifiableCollection(Collection c)
Liefert eine neue, unveränderbare Collection mit den Elementen aus c.
public static List unmodifiableList(List list)
Liefert eine neue, unveränderbare List mit den Elementen aus list.
public static Map unmodifiableMap(Map m)
Liefert eine neue, unveränderbare Map mit den Elementen aus m.
public static Set unmodifiableSet(Set s)
Liefert eine neue, unveränderbare Set mit den Elementen aus s.
public static SortedMap unmodifiableSortedMap(SortedMap m)
Liefert eine neue, unveränderbare Map mit den Elementen aus m.
public static Set unmodifiableSortedSet(SortedSet s)
Liefert eine neue, unveränderbare SortedSet mit den Elementen aus s.


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

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