Spec-Zone.ru › OpenJDK 25

Класс 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(Collection), Collection.removeIf(Predicate) или Iterable.forEach(Consumer), не гарантируется выполнять атомарно. Например, обход 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)
Возвращает представление части этого множества, элементы которой меньше toElement (или равны ему, если inclusive имеет значение true).
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)
Возвращает представление части этого множества, элементы которой больше fromElement (или равны ему, если inclusive имеет значение true).

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

hashCode

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

addAll, containsAll, retainAll, toArray, toArray, toString

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

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

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

parallelStream, removeIf, stream, toArray

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

forEach

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

removeFirst, removeLast, reversed

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

addAll, containsAll, hashCode, retainAll, toArray, toArray

Методы, объявленные в интерфейсе 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 для разных реализаций интерфейса множества.
Определено в:
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)
Удаляет из этого множества все элементы, содержащиеся в указанной коллекции. Если указанная коллекция также является множеством, эта операция фактически изменяет это множество так, что его значение становится асимметрической разностью множеств этих двух множеств.
Определено в:
removeAll в интерфейсе Collection<E>
Определено в:
removeAll в интерфейсе Set<E>
Переопределяет:
removeAll в классе AbstractSet<E>
Параметры:
c — коллекция, содержащая элементы, которые необходимо удалить из этого множества
Возвращает:
true, если это множество изменилось в результате вызова
Исключения:
ClassCastException — если класс элемента этого множества несовместим с указанной коллекцией (необязательно)
NullPointerException — если указанная коллекция или любой из ее элементов равен null
См. также:
  • AbstractCollection.remove(Object)
  • AbstractCollection.contains(Object)

lower

public E lower(E e)
Описание скопировано из интерфейса: NavigableSet
Возвращает наибольший элемент этого множества, строго меньший указанного элемента, или null, если такого элемента нет.
Определено в:
lower в интерфейсе NavigableSet<E>
Параметры:
e — значение для поиска
Возвращает:
наибольший элемент, меньший e, или null, если такого элемента нет
Исключения:
ClassCastException — если указанный элемент нельзя сравнить с элементами, находящимися в множестве
NullPointerException — если указанный элемент равен null

floor

public E floor(E e)
Описание скопировано из интерфейса: NavigableSet
Возвращает наибольший элемент этого множества, меньший или равный указанному элементу, или null, если такого элемента нет.
Определено в:
floor в интерфейсе NavigableSet<E>
Параметры:
e — значение для поиска
Возвращает:
наибольший элемент, меньший или равный e, или null, если такого элемента нет
Исключения:
ClassCastException — если указанный элемент нельзя сравнить с элементами, находящимися в множестве
NullPointerException — если указанный элемент равен null

ceiling

public E ceiling(E e)
Описание скопировано из интерфейса: NavigableSet
Возвращает наименьший элемент этого множества, больший или равный указанному элементу, или null, если такого элемента нет.
Определено в:
ceiling в интерфейсе NavigableSet<E>
Параметры:
e — значение для поиска
Возвращает:
наименьший элемент, больший или равный e, или null, если такого элемента нет
Исключения:
ClassCastException — если указанный элемент нельзя сравнить с элементами, находящимися в множестве
NullPointerException — если указанный элемент равен null

higher

public E higher(E e)
Описание скопировано из интерфейса: NavigableSet
Возвращает наименьший элемент этого множества, строго больший указанного элемента, или null, если такого элемента нет.
Определено в:
higher в интерфейсе NavigableSet<E>
Параметры:
e — значение для поиска
Возвращает:
наименьший элемент, больший e, или null, если такого элемента нет
Исключения:
ClassCastException — если указанный элемент нельзя сравнить с элементами, находящимися в множестве
NullPointerException — если указанный элемент равен null

pollFirst

public E pollFirst()
Описание скопировано из интерфейса: NavigableSet
Извлекает и удаляет первый (наименьший) элемент или возвращает null, если множество пусто (необязательная операция).
Определено в:
pollFirst в интерфейсе NavigableSet<E>
Возвращает:
первый элемент или null, если множество пусто

pollLast

public E pollLast()
Описание скопировано из интерфейса: NavigableSet
Извлекает и удаляет последний (наибольший) элемент или возвращает null, если множество пусто (необязательная операция).
Определено в:
pollLast в интерфейсе NavigableSet<E>
Возвращает:
последний элемент или null, если множество пусто

comparator

public Comparator<? super E> comparator()
Описание скопировано из интерфейса: SortedSet
Возвращает компаратор, используемый для упорядочения элементов этого множества, или null, если множество использует естественный порядок элементов.
Определено в:
comparator в интерфейсе SortedSet<E>
Возвращает:
компаратор, используемый для упорядочения элементов этого множества, или null, если множество использует естественный порядок элементов

first

public E first()
Описание скопировано из интерфейса: SortedSet
Возвращает первый (наименьший) элемент, находящийся в этом множестве.
Определено в:
first в интерфейсе SortedSet<E>
Возвращает:
первый (наименьший) элемент, находящийся в этом множестве
Исключения:
NoSuchElementException — если это множество пусто

last

public E last()
Описание скопировано из интерфейса: SortedSet
Возвращает последний (наибольший) элемент, находящийся в этом множестве.
Определено в:
last в интерфейсе SortedSet<E>
Возвращает:
последний (наибольший) элемент, находящийся в этом множестве
Исключения:
NoSuchElementException — если это множество пусто

addFirst

public void addFirst(E e)
Выбрасывает UnsupportedOperationException. Порядок обхода, задаваемый методом сравнения этого множества, определяет расположение элементов, поэтому явное указание позиции не поддерживается.
Определено в:
addFirst в интерфейсе SequencedCollection<E>
Определено в:
addFirst в интерфейсе SortedSet<E>
Параметры:
e — добавляемый элемент
Исключения:
UnsupportedOperationException — всегда
Начиная с версии:
21

addLast

public void addLast(E e)
Выбрасывает UnsupportedOperationException. Порядок обхода, задаваемый методом сравнения этого множества, определяет расположение элементов, поэтому явное указание позиции не поддерживается.
Определено в:
addLast в интерфейсе SequencedCollection<E>
Определено в:
addLast в интерфейсе SortedSet<E>
Параметры:
e — добавляемый элемент.
Исключения:
UnsupportedOperationException — всегда
Начиная с версии:
21

subSet

public NavigableSet<E> subSet(E fromElement, boolean fromInclusive, E toElement, boolean toInclusive)
Описание скопировано из интерфейса: NavigableSet
Возвращает представление части этого множества, элементы которой находятся в диапазоне от fromElement до toElement. Если fromElement и toElement равны, возвращаемое множество пусто, если только fromInclusive и toInclusive не равны true одновременно. Возвращаемое множество основано на этом множестве, поэтому изменения в возвращаемом множестве отражаются в этом множестве и наоборот. Возвращаемое множество поддерживает все необязательные операции с множествами, поддерживаемые этим множеством.

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

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

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

tailSet

public NavigableSet<E> tailSet(E fromElement, boolean inclusive)
Описание скопировано из интерфейса: NavigableSet
Возвращает представление части этого множества, элементы которой больше (или равны, если inclusive равно true) 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

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в документации Java SE, содержащей более подробные описания для разработчиков, обзоры концепций, определения терминов, обходные решения и примеры работающего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или её аффилированных лиц в США и других странах.
Авторское право © 1993, 2025, Oracle и/или её аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 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://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/util/concurrent/ConcurrentSkipListSet.html

Spec-Zone.ru

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