Класс ConcurrentSkipListSet<E>

java.lang.Object

java.util.AbstractCollection<E>

java.util.AbstractSet<E>

java.util.concurrent.ConcurrentSkipListSet<E>

Type Parameters:: E - тип элементов, поддерживаемых этим множеством

Все реализованные интерфейсы:: Serializable, Cloneable, Iterable<E>, Collection<E>, NavigableSet<E>, SequencedCollection<E>, SequencedSet<E>, Set<E>, SortedSet<E>

public class ConcurrentSkipListSet<E> extends AbstractSet<E> implements NavigableSet<E>, Cloneable, Serializable

Масштабируемая конкурентная реализация NavigableSet на основе ConcurrentSkipListMap. Элементы множества хранятся в отсортированном порядке в соответствии с их естественным порядком сортировки или с помощью Comparator, предоставленного при создании множества, в зависимости от используемого конструктора.

Эта реализация обеспечивает ожидаемую среднюю стоимость времени log(n) для операций contains, add, и remove и их вариантов. Вставки, удаления и операции доступа безопасно выполняются параллельно несколькими потоками.

Итераторы и разделители являются слабо согласованными.

Возрастающие упорядоченные представления и их итераторы быстрее, чем убывающие.

Обратите внимание, что, в отличие от большинства коллекций, метод size не является операцией с постоянной стоимостью. Из-за асинхронной природы этих множеств определение текущего числа элементов требует обхода элементов, и поэтому может сообщать неточные результаты, если эта коллекция изменяется во время обхода.

Массовые операции, добавляющие, удаляющие или проверяющие несколько элементов, такие как AbstractCollection.addAll(java.util.Collection<? extends E>), Collection.removeIf(java.util.function.Predicate<? super E>) или Iterable.forEach(java.util.function.Consumer<? super T>), не гарантированы как атомарные операции. Например, обход forEach одновременно с операцией addAll может наблюдать только часть добавленных элементов.

Этот класс и его итераторы реализуют все необязательные методы интерфейсов Set и Iterator. Как и большинство других реализаций конкурентных коллекций, этот класс не допускает использование null элементов, поскольку null аргументы и возвращаемые значения не могут быть надёжно отличимы от отсутствия элементов.

Этот класс является частью Java Collections Framework.

Since:

1.6

See Also:

Краткое описание конструкторов

Конструктор	Описание
`ConcurrentSkipListSet()`	Создаёт новый пустой набор, сортирующий свои элементы в соответствии с их естественным порядком.
`ConcurrentSkipListSet(Collection<? extends E> c)`	Создаёт новый набор, содержащий элементы указанной коллекции, сортирующий свои элементы в соответствии с их естественным порядком.
`ConcurrentSkipListSet(Comparator<? super E> comparator)`	Создаёт новый пустой набор, сортирующий свои элементы в соответствии с указанным компаратором.
`ConcurrentSkipListSet(SortedSet<E> s)`	Создаёт новый набор, содержащий те же элементы и использующий ту же сортировку, что и указанный отсортированный набор.

Краткое описание методов

Модификатор и тип	Метод	Описание
`boolean`	`add(E e)`	Добавляет указанный элемент в этот набор, если он ещё не присутствует.
`void`	`addFirst(E e)`	Выбрасывает `UnsupportedOperationException`.
`void`	`addLast(E e)`	Выбрасывает `UnsupportedOperationException`.
`E`	`ceiling(E e)`	Возвращает наименьший элемент в этом наборе, больший или равный заданному элементу, или `null` , если такого элемента нет.
`void`	`clear()`	Удаляет все элементы из этого набора.
`ConcurrentSkipListSet<E>`	`clone()`	Возвращает неглубокую копию этого `ConcurrentSkipListSet` экземпляра.
`Comparator<? super E>`	`comparator()`	Возвращает компаратор, используемый для сортировки элементов в этом наборе, или `null` , если этот набор использует естественный порядок своих элементов.
`boolean`	`contains(Object o)`	Возвращает `true` , если этот набор содержит указанный элемент.
`Iterator<E>`	`descendingIterator()`	Возвращает итератор по элементам в этом наборе в порядке убывания.
`NavigableSet<E>`	`descendingSet()`	Возвращает представление в обратном порядке элементов, содержащихся в этом наборе.
`boolean`	`equals(Object o)`	Сравнивает указанный объект с этим набором на равенство.
`E`	`first()`	Возвращает первый (наименьший) элемент, текущий в этом наборе.
`E`	`floor(E e)`	Возвращает наибольший элемент в этом наборе, меньший или равный заданному элементу, или `null` , если такого элемента нет.
`NavigableSet<E>`	`headSet(E toElement)`	Возвращает представление части этого набора, элементы которого строго меньше `toElement`.
`NavigableSet<E>`	`headSet(E toElement, boolean inclusive)`	Возвращает представление части этого набора, элементы которого меньше (или равны, если `inclusive` равно true) `toElement`.
`E`	`higher(E e)`	Возвращает наименьший элемент в этом наборе, строго больший, чем заданный элемент, или `null` , если такого элемента нет.
`boolean`	`isEmpty()`	Возвращает `true` , если этот набор не содержит элементов.
`Iterator<E>`	`iterator()`	Возвращает итератор по элементам в этом наборе в порядке возрастания.
`E`	`last()`	Возвращает последний (наибольший) элемент, текущий в этом наборе.
`E`	`lower(E e)`	Возвращает наибольший элемент в этом наборе, строго меньший, чем заданный элемент, или `null` , если такого элемента нет.
`E`	`pollFirst()`	Получает и удаляет первый (наименьший) элемент или возвращает `null` , если этот набор пуст.
`E`	`pollLast()`	Получает и удаляет последний (наибольший) элемент или возвращает `null` , если этот набор пуст.
`boolean`	`remove(Object o)`	Удаляет указанный элемент из этого набора, если он присутствует.
`boolean`	`removeAll(Collection<?> c)`	Удаляет из этого набора все его элементы, которые содержатся в указанной коллекции.
`int`	`size()`	Возвращает количество элементов в этом наборе.
`Spliterator<E>`	`spliterator()`	Возвращает `Spliterator` по элементам в этом наборе.
`NavigableSet<E>`	`subSet(E fromElement, boolean fromInclusive, E toElement, boolean toInclusive)`	Возвращает представление части этого набора, элементы которого находятся в диапазоне от `fromElement` до `toElement`.
`NavigableSet<E>`	`subSet(E fromElement, E toElement)`	Возвращает представление части этого набора, элементы которого находятся в диапазоне от `fromElement`, включительно, до `toElement`, не включительно.
`NavigableSet<E>`	`tailSet(E fromElement)`	Возвращает представление части этого набора, элементы которого больше или равны `fromElement`.
`NavigableSet<E>`	`tailSet(E fromElement, boolean inclusive)`	Возвращает представление части этого набора, элементы которого больше (или равны, если `inclusive` равно true) `fromElement`.

Методы, объявленные в классе java.util.AbstractSet

hashCode

Методы, объявленные в классе java.util.AbstractCollection

addAll, containsAll, retainAll, toArray, toArray, toString

Методы, объявленные в классе java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Методы, объявленные в интерфейсе java.util.Collection

parallelStream, removeIf, stream, toArray

Методы, объявленные в интерфейсе java.lang.Iterable

forEach

Методы, объявленные в интерфейсе java.util.NavigableSet

removeFirst, removeLast, reversed

Методы, объявленные в интерфейсе java.util.Set

addAll, containsAll, hashCode, retainAll, toArray, toArray

Методы, объявленные в интерфейсе java.util.SortedSet

getFirst, getLast

Подробное описание конструкторов

ConcurrentSkipListSet

public ConcurrentSkipListSet()

Создаёт новый пустой набор, упорядочивающий свои элементы в соответствии с их естественным порядком.

ConcurrentSkipListSet

public ConcurrentSkipListSet(Comparator<? super E> comparator)

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

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

ConcurrentSkipListSet

public ConcurrentSkipListSet(Collection<? extends E> c)

Создаёт новый набор, содержащий элементы в указанной коллекции, упорядочивающий свои элементы в соответствии с их естественным порядком.

Параметры:: c - Элементы, которые составят новый набор
Исключения:: ClassCastException - если элементы в c не Comparable, или не взаимосравнимы; NullPointerException - если указанная коллекция или любой из её элементов равны null

ConcurrentSkipListSet

public ConcurrentSkipListSet(SortedSet<E> s)

Создаёт новый набор, содержащий те же элементы и использующий то же упорядочивание, что и указанный упорядоченный набор.

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

Подробное описание методов

clone

public ConcurrentSkipListSet<E> clone()

Возвращает поверхностную копию этого экземпляра ConcurrentSkipListSet. (Сами элементы не клонируются.)

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

clone в классе Object

Возвращает:

поверхностную копию этого набора

См. также:

size

public int size()

Возвращает количество элементов в этом наборе. Если этот набор содержит более Integer.MAX_VALUE элементов, он возвращает Integer.MAX_VALUE.

Обратите внимание, что, в отличие от большинства коллекций, этот метод НЕ является операцией постоянного времени. Из-за асинхронной природы этих наборов, определение текущего количества элементов требует их полного обхода для подсчёта. Кроме того, размер может изменяться во время выполнения этого метода, в этом случае возвращённый результат будет неточным. Таким образом, этот метод обычно не очень полезен в приложениях с конкурентным выполнением.

Определено в:: size в интерфейсе Collection<E>
Определено в:: size в интерфейсе Set<E>
Возвращает:: количество элементов в этом наборе

isEmpty

public boolean isEmpty()

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

Определено в:: isEmpty в интерфейсе Collection<E>
Определено в:: isEmpty в интерфейсе Set<E>
Переопределяет:: isEmpty в классе AbstractCollection<E>
Возвращает:: true , если этот набор не содержит элементов

contains

public boolean contains(Object o)

Возвращает true , если этот набор содержит указанный элемент. Более формально, возвращает true тогда и только тогда, когда этот набор содержит элемент e такой, что o.equals(e).

Определено в:: contains в интерфейсе Collection<E>
Определено в:: contains в интерфейсе Set<E>
Переопределяет:: contains в классе AbstractCollection<E>
Параметры:: o - элемент, который проверяется на наличие в этом наборе
Возвращает:: true , если этот набор содержит указанный элемент
Исключения:: ClassCastException - если указанный элемент не может быть сравнен с элементами, которые в данный момент находятся в этом наборе; NullPointerException - если указанный элемент равен null

add

public boolean add(E e)

Добавляет указанный элемент в этот набор, если он ещё не присутствует. Более формально, добавляет указанный элемент e в этот набор, если набор не содержит элемент e2 такой, что e.equals(e2). Если этот набор уже содержит элемент, вызов оставляет набор неизменным и возвращает false.

Определено в:: add в интерфейсе Collection<E>
Определено в:: add в интерфейсе Set<E>
Переопределяет:: add в классе AbstractCollection<E>
Параметры:: e - элемент, который нужно добавить в этот набор
Возвращает:: true , если этот набор ещё не содержал указанный элемент
Исключения:: ClassCastException - если e не может быть сравнен с элементами, которые в данный момент находятся в этом наборе; NullPointerException - если указанный элемент равен null

remove

public boolean remove(Object o)

Удаляет указанный элемент из этого набора, если он присутствует. Более формально, удаляет элемент e такой, что o.equals(e), если этот набор содержит такой элемент. Возвращает true , если этот набор содержал элемент (или эквивалентно, если этот набор изменился в результате вызова). (Этот набор не будет содержать элемент после возвращения вызова.)

Определено в:: remove в интерфейсе Collection<E>
Определено в:: remove в интерфейсе Set<E>
Переопределяет:: remove в классе AbstractCollection<E>
Параметры:: o - элемент, который нужно удалить из этого набора, если он присутствует
Возвращает:: true , если этот набор содержал указанный элемент
Исключения:: ClassCastException - если o не может быть сравнен с элементами, которые в данный момент находятся в этом наборе; NullPointerException - если указанный элемент равен null

clear

public void clear()

Удаляет все элементы из этого набора.

Определено в:: clear в интерфейсе Collection<E>
Определено в:: clear в интерфейсе Set<E>
Переопределяет:: clear в классе AbstractCollection<E>

iterator

public Iterator<E> iterator()

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

Определено в:: iterator в интерфейсе Collection<E>
Определено в:: iterator в интерфейсе Iterable<E>
Определено в:: iterator в интерфейсе NavigableSet<E>
Определено в:: iterator в интерфейсе Set<E>
Определено в:: iterator в классе AbstractCollection<E>
Возвращает:: итератор по элементам в этом наборе в возрастающем порядке

descendingIterator

public Iterator<E> descendingIterator()

Возвращает итератор по элементам в этом наборе в убывающем порядке.

Определено в:: descendingIterator в интерфейсе NavigableSet<E>
Возвращает:: итератор по элементам в этом наборе в убывающем порядке

equals

public boolean equals(Object o)

Сравнивает указанный объект с этим набором на предмет равенства. Возвращает true , если указанный объект также является набором, оба набора имеют одинаковый размер и каждый член указанного набора содержится в этом наборе (или, что эквивалентно, каждый член этого набора содержится в указанном наборе). Это определение гарантирует, что метод equals работает корректно в разных реализациях интерфейса набора.

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

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

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

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

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

equals в классе AbstractSet<E>

Параметры:

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

Возвращает:

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

См. также:

removeAll

public boolean removeAll(Collection<?> c)

Удаляет из этого множества все его элементы, которые содержатся в указанной коллекции. Если указанная коллекция также является множеством, эта операция эффективно изменяет это множество таким образом, что его значение является асимметрической разностью двух множеств.

Specified by:

removeAll in interface Collection<E>

Specified by:

removeAll in interface Set<E>

Overrides:

removeAll in class AbstractSet<E>

Parameters:

c - коллекция, содержащая элементы, которые нужно удалить из этого множества

Returns:

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

Throws:

ClassCastException - если класс элемента этого множества несовместим с указанной коллекцией (опционально)

NullPointerException - если указанная коллекция или любой из ее элементов равны null

See Also:

lower

public E lower(E e)

Описание скопировано из интерфейса: NavigableSet

Возвращает наибольший элемент в этом множестве, строго меньший, чем заданный элемент, или null если такого элемента нет.

Specified by:: lower in interface NavigableSet<E>
Parameters:: e - значение для сопоставления
Returns:: наибольший элемент, меньший чем e, или null если такого элемента нет
Throws:: ClassCastException - если заданный элемент нельзя сравнить с элементами, которые в настоящее время находятся в множестве; NullPointerException - если заданный элемент равен null

floor

public E floor(E e)

Описание скопировано из интерфейса: NavigableSet

Возвращает наибольший элемент в этом множестве, меньший или равный заданному элементу, или null если такого элемента нет.

Specified by:: floor in interface NavigableSet<E>
Parameters:: e - значение для сопоставления
Returns:: наибольший элемент, меньший или равный e, или null если такого элемента нет
Throws:: ClassCastException - если заданный элемент нельзя сравнить с элементами, которые в настоящее время находятся в множестве; NullPointerException - если заданный элемент равен null

ceiling

public E ceiling(E e)

Описание скопировано из интерфейса: NavigableSet

Возвращает наименьший элемент в этом множестве, больший или равный заданному элементу, или null если такого элемента нет.

Specified by:: ceiling in interface NavigableSet<E>
Parameters:: e - значение для сопоставления
Returns:: наименьший элемент, больший или равный e, или null если такого элемента нет
Throws:: ClassCastException - если заданный элемент нельзя сравнить с элементами, которые в настоящее время находятся в множестве; NullPointerException - если заданный элемент равен null

higher

public E higher(E e)

Описание скопировано из интерфейса: NavigableSet

Возвращает наименьший элемент в этом множестве, строго больший, чем заданный элемент, или null если такого элемента нет.

Specified by:: higher in interface NavigableSet<E>
Parameters:: e - значение для сопоставления
Returns:: наименьший элемент, больший чем e, или null если такого элемента нет
Throws:: ClassCastException - если заданный элемент нельзя сравнить с элементами, которые в настоящее время находятся в множестве; NullPointerException - если заданный элемент равен null

pollFirst

public E pollFirst()

Описание скопировано из интерфейса: NavigableSet

Извлекает и удаляет первый (наименьший) элемент или возвращает null если это множество пусто.

Specified by:: pollFirst in interface NavigableSet<E>
Returns:: первый элемент или null если это множество пусто

pollLast

public E pollLast()

Описание скопировано из интерфейса: NavigableSet

Извлекает и удаляет последний (наибольший) элемент или возвращает null если это множество пусто.

Specified by:: pollLast in interface NavigableSet<E>
Returns:: последний элемент или null если это множество пусто

comparator

public Comparator<? super E> comparator()

Описание скопировано из интерфейса: SortedSet

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

Specified by:: comparator in interface SortedSet<E>
Returns:: компаратор, используемый для упорядочивания элементов в этом множестве, или null если это множество использует естественный порядок элементов

first

public E first()

Описание скопировано из интерфейса: SortedSet

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

Specified by:: first in interface SortedSet<E>
Returns:: первый (наименьший) элемент, который в данный момент находится в этом множестве
Throws:: NoSuchElementException - если это множество пусто

last

public E last()

Описание скопировано из интерфейса: SortedSet

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

Specified by:: last in interface SortedSet<E>
Returns:: последний (наибольший) элемент, который в данный момент находится в этом множестве
Throws:: NoSuchElementException - если это множество пусто

addFirst

public void addFirst(E e)

Выбрасывает UnsupportedOperationException. Порядок встречи, определяемый методом сравнения этого множества, определяет положение элементов, поэтому явное позиционирование не поддерживается.

Specified by:: addFirst in interface SequencedCollection<E>
Specified by:: addFirst in interface SortedSet<E>
Parameters:: e - добавляемый элемент
Throws:: UnsupportedOperationException - всегда
Since:: 21

addLast

public void addLast(E e)

Specified by:: addLast in interface SequencedCollection<E>
Specified by:: addLast in interface SortedSet<E>
Parameters:: e - добавляемый элемент.
Throws:: UnsupportedOperationException - всегда
Since:: 21

subSet

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

Описание скопировано из интерфейса: NavigableSet

Возвращает представление части этого набора, элементы которого находятся в диапазоне от fromElement до toElement. Если fromElement и toElement равны, возвращаемый набор пуст, если только


 fromInclusive

и toInclusive не оба истинны. Возвращаемый набор поддерживается этим набором, поэтому изменения в возвращаемом наборе отражаются в этом наборе и наоборот. Возвращаемый набор поддерживает все необязательные операции набора, которые поддерживает этот набор.

Возвращаемый набор будет выбрасывать IllegalArgumentException при попытке вставить элемент за пределами своего диапазона.

Определено в:: subSet в интерфейсе NavigableSet<E>
Параметры:: fromElement - нижняя граница возвращаемого набора; fromInclusive - true, если нижняя граница должна быть включена в возвращаемое представление; toElement - верхняя граница возвращаемого набора; toInclusive - true, если верхняя граница должна быть включена в возвращаемое представление
Возвращает:: представление части этого набора, элементы которого находятся в диапазоне от fromElement, включительно, до toElement, не включительно
Исключения:: ClassCastException - если fromElement и toElement нельзя сравнить друг с другом, используя компаратор этого набора (или, если набор не имеет компаратора, используя естественный порядок). Реализации могут, но не обязаны, выбрасывать это исключение, если fromElement или toElement нельзя сравнить с элементами, которые в настоящее время находятся в наборе.; NullPointerException - если fromElement или toElement равно null; IllegalArgumentException - если fromElement больше toElement; или если у этого набора есть ограниченный диапазон, и fromElement или toElement лежит за пределами границ диапазона.

headSet

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

Описание скопировано из интерфейса: NavigableSet

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

Определено в:: headSet в интерфейсе NavigableSet<E>
Параметры:: toElement - верхняя граница возвращаемого набора; inclusive - true если верхняя граница должна быть включена в возвращаемое представление
Возвращает:: представление части этого набора, элементы которого меньше (или равны, если inclusive истинно) toElement
Исключения:: ClassCastException - если toElement не совместим с компаратором этого набора (или, если у набора нет компаратора, если toElement не реализует Comparable). Реализации могут, но не обязаны, выбрасывать это исключение, если toElement нельзя сравнить с элементами, которые в настоящее время находятся в наборе.; NullPointerException - если toElement равно null; IllegalArgumentException - если у этого набора есть ограниченный диапазон, и toElement лежит за пределами границ диапазона

tailSet

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

Описание скопировано из интерфейса: NavigableSet

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

Определено в:: tailSet в интерфейсе NavigableSet<E>
Параметры:: fromElement - нижняя граница возвращаемого набора; inclusive - true если нижняя граница должна быть включена в возвращаемое представление
Возвращает:: представление части этого набора, элементы которого больше или равны fromElement
Исключения:: ClassCastException - если fromElement не совместим с компаратором этого набора (или, если у набора нет компаратора, если fromElement не реализует Comparable). Реализации могут, но не обязаны, выбрасывать это исключение, если fromElement нельзя сравнить с элементами, которые в настоящее время находятся в наборе.; NullPointerException - если fromElement равно null; IllegalArgumentException - если у этого набора есть ограниченный диапазон, и fromElement лежит за пределами границ диапазона

subSet

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

Описание скопировано из интерфейса: NavigableSet

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

Эквивалентно subSet(fromElement, true, toElement, false).

Определено в:: subSet в интерфейсе NavigableSet<E>
Определено в:: subSet в интерфейсе SortedSet<E>
Параметры:: fromElement - нижняя граница (включительно) возвращаемого набора; toElement - верхняя граница (не включительно) возвращаемого набора
Возвращает:: представление части этого набора, элементы которого находятся в диапазоне от fromElement, включительно, до toElement, не включительно
Исключения:: ClassCastException - если fromElement и toElement нельзя сравнить друг с другом, используя компаратор этого набора (или, если у набора нет компаратора, используя естественный порядок). Реализации могут, но не обязаны, выбрасывать это исключение, если fromElement или toElement нельзя сравнить с элементами, которые в настоящее время находятся в наборе.; NullPointerException - если fromElement или toElement равно null; IllegalArgumentException - если fromElement больше toElement; или если у этого набора есть ограниченный диапазон, и fromElement или toElement лежит за пределами границ диапазона

headSet

public NavigableSet<E> headSet(E toElement)

Описание скопировано из интерфейса: NavigableSet

Возвращает представление части этого набора, элементы которого строго меньше toElement. Возвращаемый набор поддерживается этим набором, поэтому изменения в возвращаемом наборе отражаются в этом наборе и наоборот. Возвращаемый набор поддерживает все необязательные операции набора, которые поддерживает этот набор.

Эквивалентно headSet(toElement, false).

Определено в:: headSet в интерфейсе NavigableSet<E>
Определено в:: headSet в интерфейсе SortedSet<E>
Параметры:: toElement - верхняя граница (не включительно) возвращаемого набора
Возвращает:: представление части этого набора, элементы которого строго меньше toElement
Исключения:: ClassCastException - если toElement не совместим с компаратором этого набора (или, если у набора нет компаратора, если toElement не реализует Comparable). Реализации могут, но не обязаны, выбрасывать это исключение, если toElement нельзя сравнить с элементами, которые в настоящее время находятся в наборе.; NullPointerException - если toElement равно null; IllegalArgumentException - если у этого набора есть ограниченный диапазон, и toElement лежит за пределами границ диапазона

tailSet

public NavigableSet<E> tailSet(E fromElement)

Описание скопировано из интерфейса: NavigableSet

Возвращает представление части этого множества, элементы которого больше или равны fromElement. Возвращаемое множество основано на этом множестве, поэтому изменения в возвращаемом множестве отражаются в этом множестве и наоборот. Возвращаемое множество поддерживает все необязательные операции множества, которые поддерживает это множество.

Возвращаемое множество будет выбрасывать IllegalArgumentException при попытке вставки элемента за пределами его диапазона.

Эквивалентно tailSet(fromElement, true).

Указано в:: tailSet в интерфейсе NavigableSet<E>
Указано в:: tailSet в интерфейсе SortedSet<E>
Параметры:: fromElement - нижняя граница (включительно) возвращаемого множества
Возвращает:: представление части этого множества, элементы которого больше или равны fromElement
Исключения:: ClassCastException - если fromElement не совместимо с компаратором этого множества (или, если у множества нет компаратора, если fromElement не реализует Comparable). Реализации могут, но не обязаны, выбрасывать это исключение, если fromElement не может быть сравнено с элементами, которые в данный момент находятся в множестве.; NullPointerException - если fromElement равно null; IllegalArgumentException - если у этого множества есть ограниченный диапазон, и fromElement выходит за пределы границ диапазона

descendingSet

public NavigableSet<E> descendingSet()

Возвращает представление элементов, содержащихся в этом множестве, в обратном порядке. Снижаемое множество основано на этом множестве, поэтому изменения в множестве отражаются в снижаемом множестве и наоборот.

Возвращаемое множество имеет порядок, эквивалентный Collections.reverseOrder(comparator()). Выражение s.descendingSet().descendingSet() возвращает представление s по существу эквивалентное s.

Указано в:: descendingSet в интерфейсе NavigableSet<E>
Возвращает:: представление этого множества в обратном порядке

spliterator

public Spliterator<E> spliterator()

Возвращает Spliterator над элементами в этом множестве.

Этот Spliterator сообщает о Spliterator.CONCURRENT, Spliterator.NONNULL, Spliterator.DISTINCT, Spliterator.SORTED и Spliterator.ORDERED с порядком встречи, который соответствует возрастанию. Реализующие классы должны документировать отображение дополнительных характеристических значений.

Компаратор спиттератора является null если компаратор множества null. В противном случае компаратор спиттератора такой же, как или накладывает такое же полное упорядочение, как и компаратор множества.

Указано в:: spliterator в интерфейсе Collection<E>
Указано в:: spliterator в интерфейсе Iterable<E>
Указано в:: spliterator в интерфейсе Set<E>
Указано в:: spliterator в интерфейсе SortedSet<E>
Возвращает:: Spliterator над элементами в этом множестве
С:: 1.8

© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/util/concurrent/ConcurrentSkipListSet.html