Класс 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 |
Создает новое множество, содержащее элементы указанной коллекции и упорядочивающее их согласно естественному порядку. |
ConcurrentSkipListSet |
Создает новое пустое множество, упорядочивающее элементы в соответствии с указанным компаратором. |
ConcurrentSkipListSet |
Создает новое множество, содержащее те же элементы и использующее тот же порядок, что и указанное отсортированное множество. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
boolean |
add |
Добавляет указанный элемент в это множество, если он еще не присутствует. |
void |
addFirst |
Выбрасывает UnsupportedOperationException. |
void |
addLast |
Выбрасывает UnsupportedOperationException. |
E |
ceiling |
Возвращает наименьший элемент этого множества, больший или равный указанному элементу, либо null, если такого элемента нет. |
void |
clear() |
Удаляет все элементы из этого множества. |
ConcurrentSkipListSet |
clone() |
Возвращает поверхностную копию этого экземпляра ConcurrentSkipListSet. |
Comparator |
comparator() |
Возвращает компаратор, используемый для упорядочивания элементов этого множества, либо null, если множество использует естественный порядок своих элементов. |
boolean |
contains |
Возвращает true, если это множество содержит указанный элемент. |
Iterator |
descendingIterator() |
Возвращает итератор по элементам этого множества в порядке убывания. |
NavigableSet |
descendingSet() |
Возвращает представление элементов этого множества в обратном порядке. |
boolean |
equals |
Сравнивает указанный объект с этим множеством на равенство. |
E |
first() |
Возвращает первый (наименьший) элемент, находящийся в данный момент в этом множестве. |
E |
floor |
Возвращает наибольший элемент этого множества, меньший или равный указанному элементу, либо null, если такого элемента нет. |
NavigableSet |
headSet |
Возвращает представление части этого множества, элементы которой строго меньше toElement. |
NavigableSet |
headSet |
Возвращает представление части этого множества, элементы которой меньше (или равны, если inclusive имеет значение true) toElement. |
E |
higher |
Возвращает наименьший элемент этого множества, строго больший указанного элемента, либо null, если такого элемента нет. |
boolean |
isEmpty() |
Возвращает true, если это множество не содержит элементов. |
Iterator |
iterator() |
Возвращает итератор по элементам этого множества в порядке возрастания. |
E |
last() |
Возвращает последний (наибольший) элемент, находящийся в данный момент в этом множестве. |
E |
lower |
Возвращает наибольший элемент этого множества, строго меньший указанного элемента, либо null, если такого элемента нет. |
E |
pollFirst() |
Извлекает и удаляет первый (наименьший) элемент либо возвращает null, если множество пусто (необязательная операция). |
E |
pollLast() |
Извлекает и удаляет последний (наибольший) элемент либо возвращает null, если множество пусто (необязательная операция). |
boolean |
remove |
Удаляет указанный элемент из этого множества, если он присутствует. |
boolean |
removeAll |
Удаляет из этого множества все элементы, содержащиеся в указанной коллекции. |
int |
size() |
Возвращает количество элементов в этом множестве. |
Spliterator |
spliterator() |
Возвращает Spliterator для обхода элементов этого множества. |
NavigableSet |
subSet |
Возвращает представление части этого множества, элементы которой находятся в диапазоне от fromElement до toElement. |
NavigableSet |
subSet |
Возвращает представление части этого множества, элементы которой находятся в диапазоне от fromElement включительно до toElement исключительно. |
NavigableSet |
tailSet |
Возвращает представление части этого множества, элементы которой больше или равны fromElement. |
NavigableSet |
tailSet |
Возвращает представление части этого множества, элементы которой больше (или равны, если inclusive имеет значение true) fromElement. |
Методы, объявленные в классе AbstractSet
hashCode | Модификатор и тип | Метод | Описание |
|---|---|---|
int |
hashCode() |
Возвращает значение хеш-кода этого множества. |
Методы, объявленные в классе AbstractCollection
addAll, containsAll, retainAll, toArray, toArray, toString | Модификатор и тип | Метод | Описание |
|---|---|---|
boolean |
addAll |
Добавляет все элементы указанной коллекции в эту коллекцию (необязательная операция). |
boolean |
containsAll |
Возвращает true, если эта коллекция содержит все элементы указанной коллекции. |
boolean |
retainAll |
Оставляет в этой коллекции только элементы, содержащиеся в указанной коллекции (необязательная операция). |
Object[] |
toArray() |
Возвращает массив, содержащий все элементы этой коллекции. |
<T> T[] |
toArray |
Возвращает массив, содержащий все элементы этой коллекции; тип возвращаемого массива во время выполнения совпадает с типом указанного массива. |
String |
toString() |
Возвращает строковое представление этой коллекции. |
Методы, объявленные в классе Object
finalize, getClass, notify, notifyAll, wait, wait, wait | Модификатор и тип | Метод | Описание |
|---|---|---|
protected void |
finalize() |
Устарело, будет удалено: этот элемент API может быть удален в будущей версии. Финализация объявлена устаревшей и будет удалена в одном из будущих выпусков. |
final Class |
getClass() |
Возвращает класс этого экземпляра Object во время выполнения. |
final void |
notify() |
Пробуждает один поток, ожидающий на мониторе этого объекта. |
final void |
notifyAll() |
Пробуждает все потоки, ожидающие на мониторе этого объекта. |
final void |
wait() |
Переводит текущий поток в состояние ожидания до пробуждения, обычно в результате уведомления или прерывания. |
final void |
wait |
Переводит текущий поток в состояние ожидания до пробуждения, обычно в результате уведомления или прерывания, либо до истечения заданного промежутка реального времени. |
final void |
wait |
Переводит текущий поток в состояние ожидания до пробуждения, обычно в результате уведомления или прерывания, либо до истечения заданного промежутка реального времени. |
Методы, объявленные в интерфейсе Collection
parallelStream, removeIf, stream, toArray | Модификатор и тип | Метод | Описание |
|---|---|---|
default Stream |
parallelStream() |
Возвращает, возможно, параллельный Stream, источником которого является эта коллекция. |
default boolean |
removeIf |
Удаляет из этой коллекции все элементы, удовлетворяющие заданному предикату (необязательная операция). |
default Stream |
stream() |
Возвращает последовательный Stream, источником которого является эта коллекция. |
default <T> T[] |
toArray |
Возвращает массив, содержащий все элементы этой коллекции; для выделения возвращаемого массива используется предоставленная функция generator. |
Методы, объявленные в интерфейсе Iterable
forEach | Модификатор и тип | Метод | Описание |
|---|---|---|
default void |
forEach |
Выполняет заданное действие для каждого элемента Iterable, пока не будут обработаны все элементы или действие не выбросит исключение. |
Методы, объявленные в интерфейсе NavigableSet
removeFirst, removeLast, reversed | Модификатор и тип | Метод | Описание |
|---|---|---|
default E |
removeFirst() |
Удаляет и возвращает первый элемент этой коллекции (необязательная операция). |
default E |
removeLast() |
Удаляет и возвращает последний элемент этой коллекции (необязательная операция). |
default NavigableSet |
reversed() |
Возвращает представление этой коллекции в обратном порядке. |
Методы, объявленные в интерфейсе Set
addAll, containsAll, retainAll, toArray, toArray | Модификатор и тип | Метод | Описание |
|---|---|---|
boolean |
addAll |
Добавляет в это множество все элементы указанной коллекции, которых в нем еще нет (необязательная операция). |
boolean |
containsAll |
Возвращает true, если это множество содержит все элементы указанной коллекции. |
boolean |
retainAll |
Оставляет в этом множестве только элементы, содержащиеся в указанной коллекции (необязательная операция). |
Object[] |
toArray() |
Возвращает массив, содержащий все элементы этого множества. |
<T> T[] |
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
size
public int size()
Integer.MAX_VALUE элементов, возвращается Integer.MAX_VALUE. Размер может измениться во время выполнения этого метода, и в таком случае возвращаемый результат будет неточным. Поэтому этот метод обычно не очень полезен в параллельных приложениях.
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)
- Определено в:
-
removeAllв интерфейсеCollection<E> - Определено в:
-
removeAllв интерфейсеSet<E> - Переопределяет:
-
removeAllв классеAbstractSet<E> - Параметры:
-
c— коллекция, содержащая элементы, которые нужно удалить из этого множества - Возвращает:
-
true, если в результате вызова это множество изменилось - Исключения:
-
ClassCastException— если класс элемента этого множества несовместим с указанной коллекцией (необязательное) -
NullPointerException— если указанная коллекция или любой из ее элементов равен null - См. также:
lower
public E lower(E e)
NavigableSetnull, если такого элемента нет.- Определено в:
-
lowerв интерфейсеNavigableSet<E> - Параметры:
-
e— значение для поиска - Возвращает:
- наибольший элемент, меньший
e, илиnull, если такого элемента нет - Исключения:
-
ClassCastException— если указанный элемент нельзя сравнить с элементами, которые в данный момент находятся в множестве -
NullPointerException— если указанный элемент равен null
floor
public E floor(E e)
NavigableSetnull, если такого элемента нет.- Определено в:
-
floorв интерфейсеNavigableSet<E> - Параметры:
-
e— значение для поиска - Возвращает:
- наибольший элемент, меньший или равный
e, илиnull, если такого элемента нет - Исключения:
-
ClassCastException— если указанный элемент нельзя сравнить с элементами, которые в данный момент находятся в множестве -
NullPointerException— если указанный элемент равен null
ceiling
public E ceiling(E e)
NavigableSetnull, если такого элемента нет.- Определено в:
-
ceilingв интерфейсеNavigableSet<E> - Параметры:
-
e— значение для поиска - Возвращает:
- наименьший элемент, больший или равный
e, илиnull, если такого элемента нет - Исключения:
-
ClassCastException— если указанный элемент нельзя сравнить с элементами, которые в данный момент находятся в множестве -
NullPointerException— если указанный элемент равен null
higher
public E higher(E e)
NavigableSetnull, если такого элемента нет.- Определено в:
-
higherв интерфейсеNavigableSet<E> - Параметры:
-
e— значение для поиска - Возвращает:
- наименьший элемент, больший
e, илиnull, если такого элемента нет - Исключения:
-
ClassCastException— если указанный элемент нельзя сравнить с элементами, которые в данный момент находятся в множестве -
NullPointerException— если указанный элемент равен null
pollFirst
public E pollFirst()
NavigableSetnull, если это множество пусто (необязательная операция).- Определено в:
-
pollFirstв интерфейсеNavigableSet<E> - Возвращает:
- первый элемент или
null, если это множество пусто
pollLast
public E pollLast()
NavigableSetnull, если это множество пусто (необязательная операция).- Определено в:
-
pollLastв интерфейсеNavigableSet<E> - Возвращает:
- последний элемент или
null, если это множество пусто
comparator
public Comparator<? super E> comparator()
SortedSetnull, если это множество использует естественный порядок своих элементов.- Определено в:
-
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)
NavigableSetfromElement до 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)
NavigableSetinclusive имеет значение 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)
NavigableSetinclusive имеет значение 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)
NavigableSetfromElement включительно до 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)
NavigableSettoElement. Возвращаемое множество поддерживается этим множеством, поэтому изменения в возвращаемом множестве отражаются в этом множестве, и наоборот. Возвращаемое множество поддерживает все необязательные операции над множеством, поддерживаемые этим множеством. При попытке вставить элемент за пределами диапазона возвращаемое множество выбросит 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)
NavigableSetfromElement. Возвращаемое множество поддерживается этим множеством, поэтому изменения в возвращаемом множестве отражаются в этом множестве, и наоборот. Возвращаемое множество поддерживает все необязательные операции над множеством, поддерживаемые этим множеством. При попытке вставить элемент за пределами диапазона возвращаемое множество выбросит 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.