Spec-Zone.ru › OpenJDK 17

Класс 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>, 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)
Добавляет указанный элемент в этот набор, если он ещё не присутствует.
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.Set

addAll, containsAll, hashCode, retainAll, toArray, toArray

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

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.hashCode()
  • HashMap

removeAll

public boolean removeAll(Collection<?> c)
Удаляет из этого множества все его элементы, содержащиеся в указанном наборе. Если указанный набор также является множеством, эта операция фактически изменяет это множество так, что его значение является симметричной разностью двух множеств.
Specified by:
removeAll в интерфейсе Collection<E>
Specified by:
removeAll в интерфейсе Set<E>
Overrides:
removeAll в классе 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 в интерфейсе NavigableSet<E>
Parameters:
e - значение для сопоставления
Returns:
наибольший элемент, меньший чем e, или null если такого элемента нет
Throws:
ClassCastException - если заданный элемент нельзя сравнить с элементами, которые в настоящее время находятся в множестве
NullPointerException - если заданный элемент равен null

floor

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

ceiling

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

higher

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

pollFirst

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

pollLast

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

comparator

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

first

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

last

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

subSet

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

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

Specified by:
subSet в интерфейсе NavigableSet<E>
Parameters:
fromElement - нижняя граница возвращаемого множества
fromInclusive - true если нижняя граница должна быть включена в возвращаемый вид
toElement - верхняя граница возвращаемого множества
toInclusive - true если верхняя граница должна быть включена в возвращаемый вид
Returns:
представление части этого множества, элементы которого находятся в диапазоне от fromElement, включительно, до toElement, не включительно
Throws:
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 при попытке вставить элемент за пределами его диапазона.

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

tailSet

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

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

Specified by:
tailSet в интерфейсе NavigableSet<E>
Parameters:
fromElement - нижняя граница возвращаемого множества
inclusive - true если нижнюю границу нужно включить в возвращаемое представление
Returns:
представление части этого множества, элементы которого больше или равны fromElement
Throws:
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).

Specified by:
subSet в интерфейсе NavigableSet<E>
Specified by:
subSet в интерфейсе SortedSet<E>
Parameters:
fromElement - нижняя граница (включительно) возвращаемого множества
toElement - верхняя граница (исключая) возвращаемого множества
Returns:
представление части этого множества, элементы которого находятся в диапазоне от fromElement, включительно, до toElement, исключая
Throws:
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).

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

tailSet

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

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

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

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

descendingSet

public NavigableSet<E> descendingSet()
Возвращает представление множества элементов, содержащихся в этом множестве, в обратном порядке. Спускающееся множество основано на этом множестве, поэтому изменения в множестве отражаются в спускающемся множестве, и наоборот.

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

Specified by:
descendingSet в интерфейсе NavigableSet<E>
Returns:
представление этого множества в обратном порядке

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, 2021, 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/17/docs/api/java.base/java/util/concurrent/ConcurrentSkipListSet.html

Spec-Zone.ru

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