Класс Collections

public static final Set EMPTY_SET

См. также:

• emptySet()

public static final List EMPTY_LIST

См. также:

• emptyList()

public static final Map EMPTY_MAP

Начиная с версии:

1.3

См. также:

• emptyMap()

public static <T extends Comparable<? super T>> void sort(List<T> list)

Примечание по реализации:

Эта реализация делегирует выполнение методу List.sort(Comparator), используя указанный список и компаратор null.

Параметры типа:

T — класс объектов в списке

Параметры:

list — список для сортировки.

Исключения:

ClassCastException — если список содержит элементы, которые не являются взаимно сравнимыми (например, строки и целые числа).

UnsupportedOperationException — если итератор списка указанного списка не поддерживает операцию set.

IllegalArgumentException — (необязательно) если реализация обнаружит, что естественный порядок элементов списка нарушает контракт Comparable

См. также:

• List.sort(Comparator)

public static <T> void sort(List<T> list, Comparator<? super T> c)

Примечание по реализации:

Эта реализация делегирует выполнение методу List.sort(Comparator), используя указанный список и компаратор.

Параметры типа:

T — класс объектов в списке

Параметры:

list — список для сортировки.

c — компаратор, определяющий порядок списка. Значение null означает, что следует использовать естественный порядок элементов.

Исключения:

ClassCastException — если список содержит элементы, которые не являются взаимно сравнимыми с помощью указанного компаратора.

UnsupportedOperationException — если итератор списка указанного списка не поддерживает операцию set.

IllegalArgumentException — (необязательно) если компаратор нарушает контракт Comparator

См. также:

• List.sort(Comparator)

public static <T> int binarySearch(List<? extends Comparable<? super T>> list, T key)

Параметры типа:

T — класс объектов в списке

Параметры:

list — список для поиска.

key — искомый ключ.

Возвращает:

индекс ключа поиска, если он содержится в списке; в противном случае — (-(insertion point) - 1). Точка вставки определяется как позиция, в которую ключ был бы вставлен в список: индекс первого элемента, превышающего ключ, или list.size(), если все элементы списка меньше указанного ключа. Обратите внимание: это гарантирует, что возвращаемое значение будет >= 0 тогда и только тогда, когда ключ найден.

Исключения:

ClassCastException — если список содержит элементы, которые не являются взаимно сравнимыми (например, строки и целые числа), или если ключ поиска нельзя сравнить с элементами списка.

public static <T> int binarySearch(List<? extends T> list, T key, Comparator<? super T> c)

Параметры типа:

T — класс объектов в списке

Параметры:

list — список для поиска.

key — искомый ключ.

c — компаратор, задающий порядок списка. Значение null означает, что следует использовать естественный порядок элементов.

Возвращает:

индекс ключа поиска, если он содержится в списке; в противном случае — (-(insertion point) - 1). Точка вставки определяется как позиция, в которую ключ был бы вставлен в список: индекс первого элемента, превышающего ключ, или list.size(), если все элементы списка меньше указанного ключа. Обратите внимание: это гарантирует, что возвращаемое значение будет >= 0 тогда и только тогда, когда ключ найден.

Исключения:

ClassCastException — если список содержит элементы, которые не являются взаимно сравнимыми с помощью указанного компаратора, или если ключ поиска нельзя сравнить с элементами списка с помощью этого компаратора.

public static void reverse(List<?> list)

Примечание к API:

Этот метод изменяет указанный список на месте. Чтобы получить представление списка в обратном порядке без изменения самого списка, используйте метод List.reversed.

Параметры:

list — список, порядок элементов которого необходимо изменить на обратный.

Исключения:

UnsupportedOperationException — если указанный список или его итератор не поддерживает операцию set.

См. также:

• List.reversed

public static void shuffle(List<?> list)

Требования к реализации:

Этот метод выполняется за линейное время. Если указанный список не реализует интерфейс RandomAccess и является большим, эта реализация перед перемешиванием копирует указанный список в массив, а затем копирует перемешанный массив обратно в список. Это позволяет избежать квадратичного времени выполнения, которое потребовалось бы при перемешивании списка с «последовательным доступом» на месте.

Параметры:

list — список для перемешивания.

Исключения:

UnsupportedOperationException — если указанный список или его итератор не поддерживает операцию set.

public static void shuffle(List<?> list, Random rnd)

Параметры:

list — список для перемешивания.

rnd — источник случайности для перемешивания списка.

Исключения:

UnsupportedOperationException — если указанный список или его итератор не поддерживает операцию set.

public static void shuffle(List<?> list, RandomGenerator rnd)

Требования к реализации:

Этот метод выполняется за линейное время. Если указанный список не реализует интерфейс RandomAccess и является большим, эта реализация перед перемешиванием копирует указанный список в массив, а затем копирует перемешанный массив обратно в список. Это позволяет избежать квадратичного времени выполнения, которое потребовалось бы при перемешивании списка с «последовательным доступом» на месте.

Параметры:

list — список для перемешивания.

rnd — источник случайности для перемешивания списка.

Исключения:

UnsupportedOperationException — если указанный список или его итератор не поддерживает операцию set.

Начиная с версии:

21

public static void swap(List<?> list, int i, int j)

Параметры:

list — список, в котором необходимо поменять элементы местами.

i — индекс одного из элементов для обмена.

j — индекс другого элемента для обмена.

Исключения:

IndexOutOfBoundsException — если i или j находится вне допустимого диапазона (i < 0 || i >= list.size() || j < 0 || j >= list.size()).

Начиная с версии:

1.4

public static <T> void fill(List<? super T> list, T obj)

Параметры типа:

T — класс объектов в списке

Параметры:

list — список, который необходимо заполнить заданным элементом.

obj — элемент, которым необходимо заполнить указанный список.

Исключения:

UnsupportedOperationException — если указанный список или его итератор не поддерживает операцию set.

public static <T> void copy(List<? super T> dest, List<? extends T> src)

Параметры типа:

T — класс объектов в списках

Параметры:

dest — целевой список.

src — исходный список.

Исключения:

IndexOutOfBoundsException — если целевой список слишком мал, чтобы вместить весь исходный список.

UnsupportedOperationException — если итератор целевого списка не поддерживает операцию set.

public static <T extends Object & Comparable<? super T>> T min(Collection<? extends T> coll)

Параметры типа:

T — класс объектов в коллекции

Параметры:

coll — коллекция, минимальный элемент которой необходимо определить.

Возвращает:

минимальный элемент заданной коллекции в соответствии с естественным порядком её элементов.

Исключения:

ClassCastException — если коллекция содержит элементы, которые не являются взаимно сравнимыми (например, строки и целые числа).

NoSuchElementException — если коллекция пуста.

См. также:

• Comparable

public static <T> T min(Collection<? extends T> coll, Comparator<? super T> comp)

Параметры типа:

T — класс объектов в коллекции

Параметры:

coll — коллекция, минимальный элемент которой необходимо определить.

comp — компаратор для определения минимального элемента. Значение null означает, что следует использовать естественный порядок элементов.

Возвращает:

минимальный элемент заданной коллекции в соответствии с указанным компаратором.

Исключения:

ClassCastException — если коллекция содержит элементы, которые не являются взаимно сравнимыми с помощью указанного компаратора.

NoSuchElementException — если коллекция пуста.

См. также:

• Comparable

public static <T extends Object & Comparable<? super T>> T max(Collection<? extends T> coll)

Параметры типа:

T — класс объектов в коллекции

Параметры:

coll — коллекция, максимальный элемент которой необходимо определить.

Возвращает:

максимальный элемент заданной коллекции в соответствии с естественным порядком её элементов.

Исключения:

ClassCastException — если коллекция содержит элементы, которые не являются взаимно сравнимыми (например, строки и целые числа).

NoSuchElementException — если коллекция пуста.

См. также:

• Comparable

public static <T> T max(Collection<? extends T> coll, Comparator<? super T> comp)

Параметры типа:

T — класс объектов в коллекции

Параметры:

coll — коллекция, максимальный элемент которой необходимо определить.

comp — компаратор для определения максимального элемента. Значение null означает, что следует использовать естественный порядок элементов.

Возвращает:

максимальный элемент заданной коллекции в соответствии с указанным компаратором.

Исключения:

ClassCastException — если коллекция содержит элементы, которые не являются взаимно сравнимыми с помощью указанного компаратора.

NoSuchElementException — если коллекция пуста.

См. также:

• Comparable

public static void rotate(List<?> list, int distance)

    Collections.rotate(list.subList(j, k+1), -1);

    Collections.rotate(l.subList(1, 4), -1);

Параметры:

list — список для циклического сдвига.

distance — расстояние циклического сдвига списка. Ограничений на это значение нет: оно может быть нулевым, отрицательным или превышать list.size().

Исключения:

UnsupportedOperationException — если указанный список или его итератор не поддерживает операцию set.

Начиная с версии:

1.4

public static <T> boolean replaceAll(List<T> list, T oldVal, T newVal)

Параметры типа:

T — класс объектов в списке

Параметры:

list — список, в котором выполняется замена.

oldVal — заменяемое старое значение.

newVal — новое значение, которым заменяется oldVal.

Возвращает:

true, если list содержал один или несколько элементов e, для которых (oldVal==null ? e==null : oldVal.equals(e)).

Исключения:

UnsupportedOperationException — если указанный список или его итератор не поддерживает операцию set.

Начиная с версии:

1.4

public static int indexOfSubList(List<?> source, List<?> target)

Параметры:

source — список, в котором выполняется поиск первого вхождения target.

target — список, который необходимо найти как подсписок source.

Возвращает:

начальную позицию первого вхождения указанного целевого списка в указанном исходном списке или -1, если такое вхождение отсутствует.

Начиная с версии:

1.4

public static int lastIndexOfSubList(List<?> source, List<?> target)

Параметры:

source — список, в котором выполняется поиск последнего вхождения target.

target — список, который необходимо найти как подсписок source.

Возвращает:

начальную позицию последнего вхождения указанного целевого списка в указанном исходном списке или -1, если такое вхождение отсутствует.

Начиная с версии:

1.4

public static <T> Collection<T> unmodifiableCollection(Collection<? extends T> c)

Примечание по реализации:

Этот метод может вернуть свой аргумент, если он уже является неизменяемым.

Параметры типа:

T — класс объектов в коллекции

Параметры:

c — коллекция, для которой требуется вернуть неизменяемое представление.

Возвращает:

неизменяемое представление указанной коллекции.

public static <T> SequencedCollection<T> unmodifiableSequencedCollection(SequencedCollection<? extends T> c)

Примечание по реализации:

Этот метод может вернуть свой аргумент, если он уже является неизменяемым.

Параметры типа:

T — класс объектов в коллекции

Параметры:

c — коллекция, для которой требуется вернуть неизменяемое представление.

Возвращает:

неизменяемое представление указанной коллекции.

С версии:

21

public static <T> Set<T> unmodifiableSet(Set<? extends T> s)

Примечание по реализации:

Этот метод может вернуть свой аргумент, если он уже является неизменяемым.

Параметры типа:

T — класс объектов во множестве

Параметры:

s — множество, для которого требуется вернуть неизменяемое представление.

Возвращает:

неизменяемое представление указанного множества.

public static <T> SequencedSet<T> unmodifiableSequencedSet(SequencedSet<? extends T> s)

Примечание по реализации:

Этот метод может вернуть свой аргумент, если он уже является неизменяемым.

Параметры типа:

T — класс объектов во множестве

Параметры:

s — множество, для которого требуется вернуть неизменяемое представление.

Возвращает:

неизменяемое представление указанного упорядоченного множества.

С версии:

21

public static <T> SortedSet<T> unmodifiableSortedSet(SortedSet<T> s)

Примечание по реализации:

Этот метод может вернуть свой аргумент, если он уже является неизменяемым.

Параметры типа:

T — класс объектов во множестве

Параметры:

s — отсортированное множество, для которого требуется вернуть неизменяемое представление.

Возвращает:

неизменяемое представление указанного отсортированного множества.

public static <T> NavigableSet<T> unmodifiableNavigableSet(NavigableSet<T> s)

Примечание по реализации:

Этот метод может вернуть свой аргумент, если он уже является неизменяемым.

Параметры типа:

T — класс объектов во множестве

Параметры:

s — навигационное множество, для которого требуется вернуть неизменяемое представление

Возвращает:

неизменяемое представление указанного навигационного множества

С версии:

1.8

public static <T> List<T> unmodifiableList(List<? extends T> list)

Примечание по реализации:

Этот метод может вернуть свой аргумент, если он уже является неизменяемым.

Параметры типа:

T — класс объектов в списке

Параметры:

list — список, для которого требуется вернуть неизменяемое представление.

Возвращает:

неизменяемое представление указанного списка.

public static <K,V> Map<K,V> unmodifiableMap(Map<? extends K, ? extends V> m)

Примечание по реализации:

Этот метод может вернуть свой аргумент, если он уже является неизменяемым.

Параметры типа:

K — класс ключей карты

V — класс значений карты

Параметры:

m — карта, для которой требуется вернуть неизменяемое представление.

Возвращает:

неизменяемое представление указанной карты.

public static <K,V> SequencedMap<K,V> unmodifiableSequencedMap(SequencedMap<? extends K, ? extends V> m)

Примечание по реализации:

Этот метод может вернуть свой аргумент, если он уже является неизменяемым.

Параметры типа:

K — класс ключей карты

V — класс значений карты

Параметры:

m — карта, для которой требуется вернуть неизменяемое представление.

Возвращает:

неизменяемое представление указанной карты.

С версии:

21

public static <K,V> SortedMap<K,V> unmodifiableSortedMap(SortedMap<K, ? extends V> m)

Примечание по реализации:

Этот метод может вернуть свой аргумент, если он уже является неизменяемым.

Параметры типа:

K — класс ключей карты

V — класс значений карты

Параметры:

m — отсортированная карта, для которой требуется вернуть неизменяемое представление.

Возвращает:

неизменяемое представление указанной отсортированной карты.

public static <K,V> NavigableMap<K,V> unmodifiableNavigableMap(NavigableMap<K, ? extends V> m)

Примечание по реализации:

Этот метод может вернуть свой аргумент, если он уже является неизменяемым.

Параметры типа:

K — класс ключей карты

V — класс значений карты

Параметры:

m — навигационная карта, для которой требуется вернуть неизменяемое представление

Возвращает:

неизменяемое представление указанной навигационной карты

С версии:

1.8

public static <T> Collection<T> synchronizedCollection(Collection<T> c)

 Collection c = Collections.synchronizedCollection(myCollection);
    ...
 synchronized (c) {
     Iterator i = c.iterator(); // Must be in the synchronized block
     while (i.hasNext())
        foo(i.next());
 }

Параметры типа:

T — класс объектов в коллекции

Параметры:

c — коллекция, которую требуется «обернуть» в синхронизированную коллекцию.

Возвращает:

синхронизированное представление указанной коллекции.

public static <T> Set<T> synchronizedSet(Set<T> s)

 Set s = Collections.synchronizedSet(new HashSet());
     ...
 synchronized (s) {
     Iterator i = s.iterator(); // Must be in the synchronized block
     while (i.hasNext())
         foo(i.next());
 }

Параметры типа:

T — класс объектов во множестве

Параметры:

s — множество, которое требуется «обернуть» в синхронизированное множество.

Возвращает:

синхронизированное представление указанного множества.

public static <T> SortedSet<T> synchronizedSortedSet(SortedSet<T> s)

 SortedSet s = Collections.synchronizedSortedSet(new TreeSet());
     ...
 synchronized (s) {
     Iterator i = s.iterator(); // Must be in the synchronized block
     while (i.hasNext())
         foo(i.next());
 }

 SortedSet s = Collections.synchronizedSortedSet(new TreeSet());
 SortedSet s2 = s.headSet(foo);
     ...
 synchronized (s) {  // Note: s, not s2!!!
     Iterator i = s2.iterator(); // Must be in the synchronized block
     while (i.hasNext())
         foo(i.next());
 }

Параметры типа:

T — класс объектов во множестве

Параметры:

s — отсортированное множество, которое требуется «обернуть» в синхронизированное отсортированное множество.

Возвращает:

синхронизированное представление указанного отсортированного множества.

public static <T> NavigableSet<T> synchronizedNavigableSet(NavigableSet<T> s)

 NavigableSet s = Collections.synchronizedNavigableSet(new TreeSet());
     ...
 synchronized (s) {
     Iterator i = s.iterator(); // Must be in the synchronized block
     while (i.hasNext())
         foo(i.next());
 }

 NavigableSet s = Collections.synchronizedNavigableSet(new TreeSet());
 NavigableSet s2 = s.headSet(foo, true);
     ...
 synchronized (s) {  // Note: s, not s2!!!
     Iterator i = s2.iterator(); // Must be in the synchronized block
     while (i.hasNext())
         foo(i.next());
 }

Параметры типа:

T — класс объектов во множестве

Параметры:

s — навигационное множество, которое требуется «обернуть» в синхронизированное навигационное множество

Возвращает:

синхронизированное представление указанного навигационного множества

С версии:

1.8

public static <T> List<T> synchronizedList(List<T> list)

 List list = Collections.synchronizedList(new ArrayList());
     ...
 synchronized (list) {
     Iterator i = list.iterator(); // Must be in synchronized block
     while (i.hasNext())
         foo(i.next());
 }

Параметры типа:

T — класс объектов в списке

Параметры:

list — список, который требуется «обернуть» в синхронизированный список.

Возвращает:

синхронизированное представление указанного списка.

public static <K,V> Map<K,V> synchronizedMap(Map<K,V> m)

 Map m = Collections.synchronizedMap(new HashMap());
     ...
 Set s = m.keySet();  // Needn't be in synchronized block
     ...
 synchronized (m) {  // Synchronizing on m, not s!
     Iterator i = s.iterator(); // Must be in synchronized block
     while (i.hasNext())
         foo(i.next());
 }

Параметры типа:

K — класс ключей карты

V — класс значений карты

Параметры:

m — карта, которую требуется «обернуть» в синхронизированную карту.

Возвращает:

синхронизированное представление указанной карты.

public static <K,V> SortedMap<K,V> synchronizedSortedMap(SortedMap<K,V> m)

 SortedMap m = Collections.synchronizedSortedMap(new TreeMap());
     ...
 Set s = m.keySet();  // Needn't be in synchronized block
     ...
 synchronized (m) {  // Synchronizing on m, not s!
     Iterator i = s.iterator(); // Must be in synchronized block
     while (i.hasNext())
         foo(i.next());
 }

 SortedMap m = Collections.synchronizedSortedMap(new TreeMap());
 SortedMap m2 = m.subMap(foo, bar);
     ...
 Set s2 = m2.keySet();  // Needn't be in synchronized block
     ...
 synchronized (m) {  // Synchronizing on m, not m2 or s2!
     Iterator i = s2.iterator(); // Must be in synchronized block
     while (i.hasNext())
         foo(i.next());
 }

Параметры типа:

K — класс ключей карты

V — класс значений карты

Параметры:

m — отсортированная карта, которую требуется «обернуть» в синхронизированную отсортированную карту.

Возвращает:

синхронизированное представление указанной отсортированной карты.

public static <K,V> NavigableMap<K,V> synchronizedNavigableMap(NavigableMap<K,V> m)

 NavigableMap m = Collections.synchronizedNavigableMap(new TreeMap());
     ...
 Set s = m.keySet();  // Needn't be in synchronized block
     ...
 synchronized (m) {  // Synchronizing on m, not s!
     Iterator i = s.iterator(); // Must be in synchronized block
     while (i.hasNext())
         foo(i.next());
 }

 NavigableMap m = Collections.synchronizedNavigableMap(new TreeMap());
 NavigableMap m2 = m.subMap(foo, true, bar, false);
     ...
 Set s2 = m2.keySet();  // Needn't be in synchronized block
     ...
 synchronized (m) {  // Synchronizing on m, not m2 or s2!
     Iterator i = s2.iterator(); // Must be in synchronized block
     while (i.hasNext())
         foo(i.next());
 }

Параметры типа:

K — класс ключей карты

V — класс значений карты

Параметры:

m — навигационная карта, которую требуется «обернуть» в синхронизированную навигационную карту

Возвращает:

синхронизированное представление указанной навигационной карты.

С версии:

1.8

public static <E> Collection<E> checkedCollection(Collection<E> c, Class<E> type)

    Collection<String> c = new HashSet<>();

    Collection<String> c = Collections.checkedCollection(
        new HashSet<>(), String.class);

Параметры типа:

E — класс объектов в коллекции

Параметры:

c — коллекция, для которой требуется вернуть представление с динамической проверкой типов

type — тип элемента, который разрешено хранить в c

Возвращает:

представление указанной коллекции с динамической проверкой типов

С версии:

1.5

public static <E> Queue<E> checkedQueue(Queue<E> queue, Class<E> type)

Параметры типа:

E — класс объектов в очереди

Параметры:

queue — очередь, для которой возвращается динамически типобезопасное представление

type — тип элемента, который может содержать queue

Возвращает:

динамически типобезопасное представление указанной очереди

Начиная с:

1.8

public static <E> Set<E> checkedSet(Set<E> s, Class<E> type)

Параметры типа:

E — класс объектов в множестве

Параметры:

s — множество, для которого возвращается динамически типобезопасное представление

type — тип элемента, который может содержать s

Возвращает:

динамически типобезопасное представление указанного множества

Начиная с:

1.5

public static <E> SortedSet<E> checkedSortedSet(SortedSet<E> s, Class<E> type)

Параметры типа:

E — класс объектов в множестве

Параметры:

s — отсортированное множество, для которого возвращается динамически типобезопасное представление

type — тип элемента, который может содержать s

Возвращает:

динамически типобезопасное представление указанного отсортированного множества

Начиная с:

1.5

public static <E> NavigableSet<E> checkedNavigableSet(NavigableSet<E> s, Class<E> type)

Параметры типа:

E — класс объектов в множестве

Параметры:

s — навигационное множество, для которого возвращается динамически типобезопасное представление

type — тип элемента, который может содержать s

Возвращает:

динамически типобезопасное представление указанного навигационного множества

Начиная с:

1.8

public static <E> List<E> checkedList(List<E> list, Class<E> type)

Параметры типа:

E — класс объектов в списке

Параметры:

list — список, для которого возвращается динамически типобезопасное представление

type — тип элемента, который может содержать list

Возвращает:

динамически типобезопасное представление указанного списка

Начиная с:

1.5

public static <K,V> Map<K,V> checkedMap(Map<K,V> m, Class<K> keyType, Class<V> valueType)

Параметры типа:

K — класс ключей карты

V — класс значений карты

Параметры:

m — карта, для которой возвращается динамически типобезопасное представление

keyType — тип ключа, который может содержать m

valueType — тип значения, которое может содержать m

Возвращает:

динамически типобезопасное представление указанной карты

Начиная с:

1.5

public static <K,V> SortedMap<K,V> checkedSortedMap(SortedMap<K,V> m, Class<K> keyType, Class<V> valueType)

Параметры типа:

K — класс ключей карты

V — класс значений карты

Параметры:

m — карта, для которой возвращается динамически типобезопасное представление

keyType — тип ключа, который может содержать m

valueType — тип значения, которое может содержать m

Возвращает:

динамически типобезопасное представление указанной карты

Начиная с:

1.5

public static <K,V> NavigableMap<K,V> checkedNavigableMap(NavigableMap<K,V> m, Class<K> keyType, Class<V> valueType)

Параметры типа:

K — тип ключей карты

V — тип значений карты

Параметры:

m — карта, для которой возвращается динамически типобезопасное представление

keyType — тип ключа, который может содержать m

valueType — тип значения, которое может содержать m

Возвращает:

динамически типобезопасное представление указанной карты

Начиная с:

1.8

public static <T> Iterator<T> emptyIterator()

Параметры типа:

T — тип элементов итератора, если бы они были

Возвращает:

пустой итератор

Начиная с:

1.7

public static <T> ListIterator<T> emptyListIterator()

Параметры типа:

T — тип элементов итератора, если бы они были

Возвращает:

пустой итератор списка

Начиная с:

1.7

public static <T> Enumeration<T> emptyEnumeration()

Параметры типа:

T — класс объектов в перечислении

Возвращает:

пустое перечисление

Начиная с:

1.7

public static final <T> Set<T> emptySet()

    Set<String> s = Collections.emptySet();

Примечание по реализации:

Реализациям этого метода не обязательно создавать отдельный объект Set при каждом вызове. Вероятно, стоимость использования этого метода будет сопоставима со стоимостью использования одноименного поля. (В отличие от этого метода, поле не обеспечивает безопасность типов.)

Параметры типа:

T — класс объектов в множестве

Возвращает:

пустое множество

Начиная с:

1.5

См. также:

• EMPTY_SET

public static <E> SortedSet<E> emptySortedSet()

    SortedSet<String> s = Collections.emptySortedSet();

Примечание по реализации:

Реализациям этого метода не обязательно создавать отдельный объект SortedSet при каждом вызове.

Параметры типа:

E — тип элементов множества, если бы они были

Возвращает:

пустое отсортированное множество

Начиная с:

1.8

public static <E> NavigableSet<E> emptyNavigableSet()

    NavigableSet<String> s = Collections.emptyNavigableSet();

Примечание по реализации:

Реализациям этого метода не обязательно создавать отдельный объект NavigableSet при каждом вызове.

Параметры типа:

E — тип элементов множества, если бы они были

Возвращает:

пустое навигационное множество

Начиная с:

1.8

public static final <T> List<T> emptyList()

    List<String> s = Collections.emptyList();

Примечание по реализации:

Реализациям этого метода не обязательно создавать отдельный объект List при каждом вызове. Вероятно, стоимость использования этого метода будет сопоставима со стоимостью использования одноименного поля. (В отличие от этого метода, поле не обеспечивает безопасность типов.)

Параметры типа:

T — тип элементов списка, если бы они были

Возвращает:

пустой неизменяемый список

Начиная с:

1.5

См. также:

• EMPTY_LIST

public static final <K,V> Map<K,V> emptyMap()

    Map<String, Date> s = Collections.emptyMap();

Примечание по реализации:

Реализациям этого метода не обязательно создавать отдельный объект Map при каждом вызове. Вероятно, стоимость использования этого метода будет сопоставима со стоимостью использования одноименного поля. (В отличие от этого метода, поле не обеспечивает безопасность типов.)

Параметры типа:

K — класс ключей карты

V — класс значений карты

Возвращает:

пустую карту

Начиная с:

1.5

См. также:

• EMPTY_MAP

public static final <K,V> SortedMap<K,V> emptySortedMap()

    SortedMap<String, Date> s = Collections.emptySortedMap();

Примечание по реализации:

Реализациям этого метода не обязательно создавать отдельный объект SortedMap при каждом вызове.

Параметры типа:

K — класс ключей карты

V — класс значений карты

Возвращает:

пустую отсортированную карту

Начиная с:

1.8

public static final <K,V> NavigableMap<K,V> emptyNavigableMap()

    NavigableMap<String, Date> s = Collections.emptyNavigableMap();

Примечание по реализации:

Реализациям этого метода не обязательно создавать отдельный объект NavigableMap при каждом вызове.

Параметры типа:

K — класс ключей карты

V — класс значений карты

Возвращает:

пустую навигационную карту

Начиная с:

1.8

public static <T> Set<T> singleton(T o)

Параметры типа:

T — класс объектов в множестве

Параметры:

o — единственный объект, который будет сохранен в возвращаемом множестве.

Возвращает:

неизменяемое множество, содержащее только указанный объект.

public static <T> List<T> singletonList(T o)

Параметры типа:

T — класс объектов в списке

Параметры:

o — единственный объект, который будет сохранен в возвращаемом списке.

Возвращает:

неизменяемый список, содержащий только указанный объект.

Начиная с:

1.3

public static <K,V> Map<K,V> singletonMap(K key, V value)

Параметры типа:

K — класс ключей карты

V — класс значений карты

Параметры:

key — единственный ключ, который будет сохранен в возвращаемой карте.

value — значение, с которым возвращаемая карта сопоставляет key.

Возвращает:

неизменяемую карту, содержащую только указанное соответствие ключа и значения.

Начиная с:

1.3

public static <T> List<T> nCopies(int n, T o)

Параметры типа:

T — класс копируемого объекта и объектов в возвращаемом списке.

Параметры:

n — количество элементов в возвращаемом списке.

o — элемент, который будет многократно включен в возвращаемый список.

Возвращает:

неизменяемый список, состоящий из n копий указанного объекта.

Выбрасывает:

IllegalArgumentException — если n < 0

См. также:

• List.addAll(Collection)
• List.addAll(int, Collection)

public static <T> Comparator<T> reverseOrder()

         Arrays.sort(a, Collections.reverseOrder());

Примечание к API:

Этот метод возвращает Comparator, подходящий для сортировки элементов в обратном порядке. Чтобы получить обратное представление упорядоченной коллекции, используйте метод SequencedCollection.reversed. Или, чтобы получить обратное представление упорядоченной карты, используйте метод SequencedMap.reversed.

Параметры типа:

T — класс объектов, сравниваемых компаратором

Возвращает:

Компаратор, задающий порядок, обратный естественному порядку, для коллекции объектов, реализующих интерфейс Comparable.

См. также:

• Comparable

public static <T> Comparator<T> reverseOrder(Comparator<T> cmp)

Примечание к API:

Этот метод возвращает Comparator, подходящий для сортировки элементов в обратном порядке. Чтобы получить обратное представление упорядоченной коллекции, используйте метод SequencedCollection.reversed. Или, чтобы получить обратное представление упорядоченной карты, используйте метод SequencedMap.reversed.

Параметры типа:

T — класс объектов, сравниваемых компаратором

Параметры:

cmp — компаратор, порядок которого должен быть обращён возвращаемым компаратором, или null

Возвращает:

Компаратор, задающий порядок, обратный порядку указанного компаратора.

Начиная с версии:

1.5

public static <T> Enumeration<T> enumeration(Collection<T> c)

Параметры типа:

T — класс объектов в коллекции

Параметры:

c — коллекция, для которой возвращается перечисление.

Возвращает:

перечисление для указанной коллекции.

См. также:

• Enumeration

public static <T> ArrayList<T> list(Enumeration<T> e)

Параметры типа:

T — класс объектов, возвращаемых перечислением

Параметры:

e — перечисление, предоставляющее элементы для возвращаемого списка-массива

Возвращает:

список-массив, содержащий элементы, возвращаемые указанным перечислением.

Начиная с версии:

1.4

См. также:

• Enumeration
• ArrayList

public static int frequency(Collection<?> c, Object o)

Параметры:

c — коллекция, в которой определяется частота появления o

o — объект, частоту появления которого нужно определить

Возвращает:

количество элементов в c, равных o

Вызывает исключение:

NullPointerException — если c равно null

Начиная с версии:

1.5

public static boolean disjoint(Collection<?> c1, Collection<?> c2)

Параметры:

c1 — коллекция

c2 — коллекция

Возвращает:

true, если две указанные коллекции не имеют общих элементов.

Вызывает исключение:

NullPointerException — если одна из коллекций равна null.

NullPointerException — если одна коллекция содержит элемент null, а null не является допустимым элементом для другой коллекции. (необязательно)

ClassCastException — если одна коллекция содержит элемент типа, недопустимого для другой коллекции. (необязательно)

Начиная с версии:

1.5

@SafeVarargs public static <T> boolean addAll(Collection<? super T> c, T... elements)

    Collections.addAll(flavors, "Peaches 'n Plutonium", "Rocky Racoon");

Параметры типа:

T — класс добавляемых элементов и коллекции

Параметры:

c — коллекция, в которую должны быть добавлены elements

elements — элементы для добавления в c

Возвращает:

true, если коллекция изменилась в результате вызова

Вызывает исключение:

UnsupportedOperationException — если c не поддерживает операцию add

NullPointerException — если elements содержит одно или несколько значений null, а c не допускает null-элементы, либо если c или elements равны null

IllegalArgumentException — если какое-либо свойство значения в elements препятствует его добавлению в c

Начиная с версии:

1.5

См. также:

• Collection.addAll(Collection)

public static <E> Set<E> newSetFromMap(Map<E,Boolean> map)

   Set<Object> weakHashSet = Collections.newSetFromMap(
       new WeakHashMap<Object, Boolean>());

Параметры типа:

E — класс ключей карты и объектов в возвращаемом наборе

Параметры:

map — исходная карта

Возвращает:

набор, основанный на карте

Вызывает исключение:

IllegalArgumentException — если map не пуста

Начиная с версии:

1.6

public static <E> SequencedSet<E> newSequencedSetFromMap(SequencedMap<E,Boolean> map)

Примечание к API:

Следующий пример кода создаёт SequencedSet из LinkedHashMap. Это отличается от LinkedHashSet тем, что removeEldestEntry карты переопределяется для реализации политики вытеснения, что невозможно с LinkedHashSet.

    SequencedSet<String> set = Collections.newSequencedSetFromMap(
        new LinkedHashMap<String, Boolean>() {
            protected boolean removeEldestEntry(Map.Entry<String, Boolean> e) {
                return this.size() > 5;
            }
       });

Параметры типа:

E — класс ключей карты и объектов в возвращаемом наборе

Параметры:

map — исходная карта

Возвращает:

набор, основанный на карте

Вызывает исключение:

IllegalArgumentException — если map не пуста

Начиная с версии:

21

public static <T> Queue<T> asLifoQueue(Deque<T> deque)

Примечание к API:

Этот метод предоставляет представление, инвертирующее смысл некоторых операций, но не меняющее порядок обхода. Чтобы получить представление с обратным порядком, используйте метод Deque.reversed.

Параметры типа:

T — класс объектов в двусторонней очереди

Параметры:

deque — двусторонняя очередь

Возвращает:

очередь

Начиная с версии:

1.6