Интерфейс SortedSet<E>

Comparator<? super E> comparator()

Возвращает:

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

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

Параметры:

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

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

Возвращает:

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

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

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

NullPointerException — если fromElement или toElement равно null, а это множество не допускает элементы null

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

SortedSet<E> headSet(E toElement)

Параметры:

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

Возвращает:

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

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

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

NullPointerException — если toElement равно null, а это множество не допускает элементы null

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

SortedSet<E> tailSet(E fromElement)

Параметры:

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

Возвращает:

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

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

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

NullPointerException — если fromElement равно null, а это множество не допускает элементы null

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

E first()

Возвращает:

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

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

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

E last()

Возвращает:

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

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

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

default Spliterator<E> spliterator()

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

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

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

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

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

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

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

Реализация по умолчанию создаёт сплитератор с поздним связыванием на основе Iterator отсортированного множества. Сплитератор наследует свойства fail-fast итератора множества. Компаратор сплитератора совпадает с компаратором отсортированного множества.

Созданный Spliterator дополнительно сообщает о характеристике Spliterator.SIZED.

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

Созданный Spliterator дополнительно сообщает о характеристике Spliterator.SUBSIZED.

Возвращает:

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

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

1.8

default void addFirst(E e)

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

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

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

Реализация в этом интерфейсе всегда выбрасывает UnsupportedOperationException.

Параметры:

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

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

UnsupportedOperationException — всегда

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

21

default void addLast(E e)

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

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

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

Реализация в этом интерфейсе всегда выбрасывает UnsupportedOperationException.

Параметры:

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

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

UnsupportedOperationException — всегда

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

21

default E getFirst()

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

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

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

Реализация в этом интерфейсе возвращает результат вызова метода first.

Возвращает:

полученный элемент

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

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

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

21

default E getLast()

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

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

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

Реализация в этом интерфейсе возвращает результат вызова метода last.

Возвращает:

полученный элемент

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

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

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

21

default E removeFirst()

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

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

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

Реализация в этом интерфейсе вызывает метод first для получения первого элемента, затем вызывает remove(element) для удаления этого элемента и возвращает его.

Возвращает:

удалённый элемент

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

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

UnsupportedOperationException — если реализация этой коллекции не поддерживает данную операцию

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

21

default E removeLast()

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

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

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

Реализация в этом интерфейсе вызывает метод last для получения последнего элемента, затем вызывает remove(element) для удаления этого элемента и возвращает его.

Возвращает:

удалённый элемент

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

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

UnsupportedOperationException — если реализация этой коллекции не поддерживает данную операцию

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

21

default SortedSet<E> reversed()

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

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

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

reversed в интерфейсе SequencedSet<E>

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

Реализация в этом интерфейсе возвращает представление SortedSet в обратном порядке. Метод reversed() этого представления возвращает ссылку на данный SortedSet. Другие операции над представлением реализованы посредством вызова открытых методов этого SortedSet. Точная связь между вызовами методов представления и вызовами методов этого SortedSet не определена. Однако операции, чувствительные к порядку, обычно ведут себя так, как если бы они делегировали вызов соответствующему методу с противоположной ориентацией. Например, вызов getFirst для представления может привести к вызову getLast для этого SortedSet.

Возвращает:

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

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

21