Интерфейс 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 отсортированного множества. Разделитель наследует свойства быстрого отказа итератора множества. Компаратор разделителя такой же, как и компаратор отсортированного множества.

Созданный 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