Класс TreeSet<E>

public TreeSet()

public TreeSet(Comparator<? super E> comparator)

Параметры:

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

public TreeSet(Collection<? extends E> c)

Параметры:

c — коллекция, элементы которой составят новое множество

Исключения:

ClassCastException — если элементы в c не являются Comparable или не являются взаимно сравнимыми

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

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