Класс TreeSet<E>

public TreeSet()

public TreeSet(Comparator<? super E> comparator)

public TreeSet(Collection<? extends E> c)

public TreeSet(SortedSet<E> s)

Параметры:

s - отсортированный набор, элементы которого составят новый набор

Исключения:

NullPointerException - если указанный отсортированный набор равен null

public Iterator<E> iterator()

Определено в:

iterator в интерфейсе Collection<E>

Определено в:

iterator в интерфейсе Iterable<E>

Определено в:

iterator в интерфейсе NavigableSet<E>

Определено в:

iterator в интерфейсе Set<E>

Определено в:

iterator в классе AbstractCollection<E>

Возвращает:

итератор по элементам в этом наборе в порядке возрастания

public Iterator<E> descendingIterator()

Определено в:

descendingIterator в интерфейсе NavigableSet<E>

Возвращает:

итератор по элементам в этом наборе в порядке убывания

С:

1.6

public NavigableSet<E> descendingSet()

Определено в:

descendingSet в интерфейсе NavigableSet<E>

Возвращает:

представление этого набора в обратном порядке

С:

1.6

public int size()

Определено в:

size в интерфейсе Collection<E>

Определено в:

size в интерфейсе Set<E>

Возвращает:

количество элементов в этом наборе (его мощность)

public boolean isEmpty()

Определено в:

isEmpty в интерфейсе Collection<E>

Определено в:

isEmpty в интерфейсе Set<E>

Переопределяет:

isEmpty в классе AbstractCollection<E>

Возвращает:

true, если этот набор не содержит элементов

public boolean contains(Object o)

Определено в:

contains в интерфейсе Collection<E>

Определено в:

contains в интерфейсе Set<E>

Переопределяет:

contains в классе AbstractCollection<E>

Параметры:

o - объект, проверяемый на наличие в этом наборе

Возвращает:

true, если этот набор содержит указанный элемент

Исключения:

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

NullPointerException - если указанный элемент равен null, и этот набор использует естественный порядок, или его компаратор не допускает null-элементов

public boolean add(E e)

Определено в:

add в интерфейсе Collection<E>

Определено в:

add в интерфейсе Set<E>

Переопределяет:

add в классе AbstractCollection<E>

Параметры:

e - элемент, который необходимо добавить в этот набор

Возвращает:

true, если этот набор ещё не содержал указанный элемент

Исключения:

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

NullPointerException - если указанный элемент равен null, и этот набор использует естественный порядок, или его компаратор не допускает null-элементов

public boolean remove(Object o)

Определено в:

remove в интерфейсе Collection<E>

Определено в:

remove в интерфейсе Set<E>

Переопределяет:

remove в классе AbstractCollection<E>

Параметры:

o - объект, который необходимо удалить из этого набора, если он присутствует

Возвращает:

true, если этот набор содержал указанный элемент

Исключения:

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

NullPointerException - если указанный элемент равен null, и этот набор использует естественный порядок, или его компаратор не допускает null-элементов

public void clear()

Определено:

clear в интерфейсе Collection<E>

Определено:

clear в интерфейсе Set<E>

Переопределяет:

clear в классе AbstractCollection<E>

public boolean addAll(Collection<? extends E> c)

Определено:

addAll в интерфейсе Collection<E>

Определено:

addAll в интерфейсе Set<E>

Переопределяет:

addAll в классе AbstractCollection<E>

Параметры:

c - набор содержащий элементы, которые должны быть добавлены в этот набор

Возвращает:

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

Исключения:

ClassCastException - если предоставленные элементы не могут быть сравнены с элементами, которые в настоящее время находятся в наборе

NullPointerException - если указанный набор равен null или любой элемент равен null, и этот набор использует естественный порядок, или его компаратор не допускает null-элементов

См. также:

• AbstractCollection.add(Object)

public NavigableSet<E> subSet(E fromElement, boolean fromInclusive, E toElement, boolean toInclusive)

Определено:

subSet в интерфейсе NavigableSet<E>

Параметры:

fromElement - нижняя граница возвращаемого набора

fromInclusive - true, если нижняя граница должна быть включена в возвращаемое представление

toElement - верхняя граница возвращаемого набора

toInclusive - true, если верхняя граница должна быть включена в возвращаемое представление

Возвращает:

представление части этого набора, элементы которого находятся в диапазоне от fromElement (включительно) до toElement (исключительно)

Исключения:

ClassCastException - если fromElement и toElement нельзя сравнить друг с другом с помощью компаратора этого набора (или, если у набора нет компаратора, используя естественный порядок). Реализации могут, но не обязаны, генерировать это исключение, если fromElement или toElement нельзя сравнить с элементами, которые в настоящее время находятся в наборе.

NullPointerException - если fromElement или toElement равно null, и этот набор использует естественный порядок, или его компаратор не допускает null-элементов

IllegalArgumentException - если fromElement больше toElement; или если сам этот набор имеет ограниченный диапазон, и fromElement или toElement выходит за пределы границ диапазона.

С:

1.6

public NavigableSet<E> headSet(E toElement, boolean inclusive)

Определено:

headSet в интерфейсе NavigableSet<E>

Параметры:

toElement - верхняя граница возвращаемого набора

inclusive - true, если верхняя граница должна быть включена в возвращаемое представление

Возвращает:

представление части этого набора, элементы которого меньше (или меньше или равны, если inclusive равно true) toElement

Исключения:

ClassCastException - если toElement несовместим с компаратором этого набора (или, если у набора нет компаратора, если toElement не реализует Comparable). Реализации могут, но не обязаны, генерировать это исключение, если toElement нельзя сравнить с элементами, которые в настоящее время находятся в наборе.

NullPointerException - если toElement равно null, и этот набор использует естественный порядок, или его компаратор не допускает null-элементов

IllegalArgumentException - если сам этот набор имеет ограниченный диапазон, и toElement выходит за пределы границ диапазона

С:

1.6

public NavigableSet<E> tailSet(E fromElement, boolean inclusive)

Определено:

tailSet в интерфейсе NavigableSet<E>

Параметры:

fromElement - нижняя граница возвращаемого набора

inclusive - true, если нижняя граница должна быть включена в возвращаемое представление

Возвращает:

представление части этого набора, элементы которого больше или равны fromElement

Исключения:

ClassCastException - если fromElement несовместим с компаратором этого набора (или, если у набора нет компаратора, если fromElement не реализует Comparable). Реализации могут, но не обязаны, генерировать это исключение, если fromElement нельзя сравнить с элементами, которые в настоящее время находятся в наборе.

NullPointerException - если fromElement равно null, и этот набор использует естественный порядок, или его компаратор не допускает null-элементов

IllegalArgumentException - если сам этот набор имеет ограниченный диапазон, и fromElement выходит за пределы границ диапазона

С:

1.6

public SortedSet<E> subSet(E fromElement, E toElement)

Определено:

subSet в интерфейсе NavigableSet<E>

Определено:

subSet в интерфейсе SortedSet<E>

Параметры:

fromElement - нижняя граница (включительно) возвращаемого набора

toElement - верхняя граница (исключительно) возвращаемого набора

Возвращает:

представление части этого набора, элементы которого находятся в диапазоне от fromElement (включительно) до toElement (исключительно)

Исключения:

ClassCastException - если fromElement и toElement нельзя сравнить друг с другом с помощью компаратора этого набора (или, если у набора нет компаратора, используя естественный порядок). Реализации могут, но не обязаны, генерировать это исключение, если fromElement или toElement нельзя сравнить с элементами, которые в настоящее время находятся в наборе.

NullPointerException - если fromElement или toElement равно null, и этот набор использует естественный порядок, или его компаратор не допускает null-элементов

IllegalArgumentException - если fromElement больше toElement; или если сам этот набор имеет ограниченный диапазон, и fromElement или toElement выходит за пределы границ диапазона

public SortedSet<E> headSet(E toElement)

Указано в:

headSet в интерфейсе NavigableSet<E>

Указано в:

headSet в интерфейсе SortedSet<E>

Параметры:

toElement - верхняя граница (исключая) возвращаемого множества

Возвращает:

представление части этого множества, элементы которого строго меньше, чем toElement

Исключения:

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

NullPointerException - если toElement равно null и это множество использует естественный порядок, или его компаратор не допускает элементов null

IllegalArgumentException - если само это множество имеет ограниченный диапазон, и toElement находится за пределами границ диапазона

public SortedSet<E> tailSet(E fromElement)

Указано в:

tailSet в интерфейсе NavigableSet<E>

Указано в:

tailSet в интерфейсе SortedSet<E>

Параметры:

fromElement - нижняя граница (включая) возвращаемого множества

Возвращает:

представление части этого множества, элементы которого больше или равны fromElement

Исключения:

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

NullPointerException - если fromElement равно null и это множество использует естественный порядок, или его компаратор не допускает элементов null

IllegalArgumentException - если само это множество имеет ограниченный диапазон, и fromElement находится за пределами границ диапазона

public Comparator<? super E> comparator()

Указано в:

comparator в интерфейсе SortedSet<E>

Возвращает:

компаратор, используемый для упорядочения элементов в этом множестве, или null, если это множество использует естественный порядок своих элементов

public E first()

Указано в:

first в интерфейсе SortedSet<E>

Возвращает:

первый (наименьший) элемент, который в данный момент находится в этом множестве

Исключения:

NoSuchElementException - если это множество пусто

public E last()

Указано в:

last в интерфейсе SortedSet<E>

Возвращает:

последний (наибольший) элемент, который в данный момент находится в этом множестве

Исключения:

NoSuchElementException - если это множество пусто

public E lower(E e)

Указано в:

lower в интерфейсе NavigableSet<E>

Параметры:

e - значение для сопоставления

Возвращает:

наибольший элемент, меньший, чем e, или null, если такого элемента нет

Исключения:

ClassCastException - если указанный элемент не может быть сравнен с элементами, которые в данный момент находятся в множестве

NullPointerException - если указанный элемент равен null и это множество использует естественный порядок, или его компаратор не допускает элементов null

С версии:

1.6

public E floor(E e)

Указано в:

floor в интерфейсе NavigableSet<E>

Параметры:

e - значение для сопоставления

Возвращает:

наибольший элемент, меньший или равный e, или null, если такого элемента нет

Исключения:

ClassCastException - если указанный элемент не может быть сравнен с элементами, которые в данный момент находятся в множестве

NullPointerException - если указанный элемент равен null и это множество использует естественный порядок, или его компаратор не допускает элементов null

С версии:

1.6

public E ceiling(E e)

Указано в:

ceiling в интерфейсе NavigableSet<E>

Параметры:

e - значение для сопоставления

Возвращает:

наименьший элемент, больший или равный e, или null, если такого элемента нет

Исключения:

ClassCastException - если указанный элемент не может быть сравнен с элементами, которые в данный момент находятся в множестве

NullPointerException - если указанный элемент равен null и это множество использует естественный порядок, или его компаратор не допускает элементов null

С версии:

1.6

public E higher(E e)

Указано в:

higher в интерфейсе NavigableSet<E>

Параметры:

e - значение для сопоставления

Возвращает:

наименьший элемент, больший, чем e, или null, если такого элемента нет

Исключения:

ClassCastException - если указанный элемент не может быть сравнен с элементами, которые в данный момент находятся в множестве

NullPointerException - если указанный элемент равен null и это множество использует естественный порядок, или его компаратор не допускает элементов null

С версии:

1.6

public E pollFirst()

Указано в:

pollFirst в интерфейсе NavigableSet<E>

Возвращает:

первый элемент или null, если это множество пусто

С версии:

1.6

public E pollLast()

Определено в:

pollLast в интерфейсе NavigableSet<E>

Возвращает:

последний элемент или null, если это множество пустое

С тех пор:

1.6

public void addFirst(E e)

Определено в:

addFirst в интерфейсе SequencedCollection<E>

Определено в:

addFirst в интерфейсе SortedSet<E>

Параметры:

e - добавляемый элемент

Бросает:

UnsupportedOperationException - всегда

С тех пор:

21

public void addLast(E e)

Определено в:

addLast в интерфейсе SequencedCollection<E>

Определено в:

addLast в интерфейсе SortedSet<E>

Параметры:

e - добавляемый элемент.

Бросает:

UnsupportedOperationException - всегда

С тех пор:

21

public Object clone()

Переопределяет:

clone в классе Object

Возвращает:

неглубокую копию этого множества

См. также:

• Cloneable

public Spliterator<E> spliterator()

Определено в:

spliterator в интерфейсе Collection<E>

Определено в:

spliterator в интерфейсе Iterable<E>

Определено в:

spliterator в интерфейсе Set<E>

Определено в:

spliterator в интерфейсе SortedSet<E>

Возвращает:

Spliterator над элементами в этом множестве

С тех пор:

1.8