Spec-Zone.ru › OpenJDK 24

Класс ConcurrentSkipListSet<E>

java.lang.Object
java.util.AbstractCollection<E>
java.util.AbstractSet<E>
java.util.concurrent.ConcurrentSkipListSet<E>
Параметры типа:
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.

С тех пор:
1.6
См. также:
  • Сериализованная форма

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

Конструктор Описание
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 истинно) 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 истинно) 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
Возвращает:
поверхностную копию этого набора
См. также:
  • Cloneable

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 работает корректно для разных реализаций интерфейса set.
Указано в:
equals в интерфейсе Collection<E>
Указано в:
equals в интерфейсе Set<E>
Переопределяет:
equals в классе AbstractSet<E>
Параметры:
o - объект, сравниваемый на предмет равенства с этим набором
Возвращает:
true, если указанный объект равен этому набору
См. также:
  • Object.equals(Object)
  • Set.equals(Object)
  • List.equals(Object)

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:
  • AbstractCollection.remove(Object)
  • AbstractCollection.contains(Object)

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)
Выбрасывает UnsupportedOperationException. Порядок встречи, заданный методом сравнения этого множества, определяет положение элементов, поэтому явное позиционирование не поддерживается.
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. Возвращаемое множество основано на этом множестве, поэтому изменения в возвращаемом множестве отражаются в этом множестве и наоборот. Возвращаемое множество поддерживает все необязательные операции множества, которые поддерживает это множество.

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

Указано в:
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. Возвращаемое множество основано на этом множестве, поэтому изменения в возвращаемом множестве отражаются в этом множестве и наоборот. Возвращаемое множество поддерживает все необязательные операции множества, которые поддерживает это множество.

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

Указано в:
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 равны, возвращаемое множество пусто.) Возвращаемое множество основано на этом множестве, поэтому изменения в возвращаемом множестве отражаются в этом множестве и наоборот. Возвращаемое множество поддерживает все необязательные операции множества, которые поддерживает это множество.

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

Эквивалентно 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. Возвращаемое множество основано на этом множестве, поэтому изменения в возвращаемом множестве отражаются в этом множестве и наоборот. Возвращаемое множество поддерживает все необязательные операции множества, которые поддерживает это множество.

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

Эквивалентно 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, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/java.base/java/util/concurrent/ConcurrentSkipListSet.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API