Spec-Zone .ru
спецификации, руководства, описания, API
|
E
- тип элементов сохраняется этим наборомpublic interface NavigableSet<E> extends SortedSet<E>
SortedSet
расширенный с помощью методов навигации, сообщая о самых близких соответствиях для данных целей поиска. Методы lower
, floor
, ceiling
, и higher
возвратите элементы соответственно меньше чем, меньше чем или равный, больше чем или равный, и больше чем данный элемент, возвращаясь null
если нет такого элемента. A NavigableSet
может быть получен доступ и пересечен или в порядке по возрастанию или в порядке по убыванию. descendingSet
метод возвращает представление набора со смыслами всех реляционных и направленных инвертированных методов. Производительность возрастающих операций и представлений, вероятно, будет быстрее чем тот из убывающих. Этот интерфейс дополнительно определяет методы pollFirst
и pollLast
тот возврат и удаляет самый низкий и самый высокий элемент, если Вы существуете, еще возвращаясь null
. Методы subSet
, headSet
, и tailSet
отличайтесь от подобно-именованного SortedSet
методы в принятии дополнительных параметров, описывающих, являются ли нижние и верхние границы содержащими против монопольного. Подмножества любого NavigableSet
должен реализовать NavigableSet
интерфейс. Возвращаемые значения методов навигации могут быть неоднозначными в реализациях то разрешение null
элементы. Однако, даже в этом случае результат может быть снят неоднозначность, проверяя contains(null)
. Чтобы избежать таких проблем, реализации этого интерфейса поощряются не разрешить вставку null
элементы. (Отметьте что сортированные наборы Comparable
элементы свойственно не разрешают null
.)
Методы subSet(E, E)
, headSet(E)
, и tailSet(E)
определяются, чтобы возвратиться SortedSet
позволить существующие реализации SortedSet
быть совместимо retrofitted, чтобы реализовать NavigableSet
, но расширения и реализации этого интерфейса поощряются переопределить эти методы, чтобы возвратиться NavigableSet
.
Этот интерфейс является элементом Платформы Наборов Java.
Модификатор и Тип | Метод и Описание |
---|---|
E |
ceiling(E e)
Возвращает наименьшее количество элемента в этом наборе, больше чем или равный данному элементу, или
null если нет такого элемента. |
Iterator<E> |
descendingIterator()
Возвращает iterator по элементам в этом наборе, в порядке убывания.
|
NavigableSet<E> |
descendingSet()
Возвращает представление обратного порядка элементов, содержавшихся в этом наборе.
|
E |
floor(E e)
Возвращает самый большой элемент в этом наборе, меньше чем или равном данному элементу, или
null если нет такого элемента. |
SortedSet<E> |
headSet(E toElement)
Возвращает представление части этого набора, элементы которого являются строго меньше чем toElement.
|
NavigableSet<E> |
headSet(E toElement, boolean inclusive)
Возвращает представление части этого набора, элементы которого являются меньше чем (или равный, если
inclusive истина), toElement . |
E |
higher(E e)
Возвращает наименьшее количество элемента в этом наборе, строго больше чем данный элемент, или
null если нет такого элемента. |
Iterator<E> |
iterator()
Возвращает iterator по элементам в этом наборе, в порядке возрастания.
|
E |
lower(E e)
Возвращает самый большой элемент в этом наборе строго меньше чем данный элемент, или
null если нет такого элемента. |
E |
pollFirst()
Получает и удаляет первый (самый низкий) элемент, или возвраты
null если этот набор пуст. |
E |
pollLast()
Получает и удаляет последний (самый высокий) элемент, или возвраты
null если этот набор пуст. |
NavigableSet<E> |
subSet(E fromElement, boolean fromInclusive, E toElement, boolean toInclusive)
Возвращает представление части этого набора, элементы которого располагаются от
fromElement к toElement . |
SortedSet<E> |
subSet(E fromElement, E toElement)
Возвращает представление части этого набора, элементы которого колеблются от fromElement, включительно, к toElement, монопольному.
|
SortedSet<E> |
tailSet(E fromElement)
Возвращает представление части этого набора, элементы которого больше чем или равны fromElement.
|
NavigableSet<E> |
tailSet(E fromElement, boolean inclusive)
Возвращает представление части этого набора, элементы которого больше чем (или равны, если
inclusive истина), fromElement . |
comparator, first, last, spliterator
add, addAll, clear, contains, containsAll, equals, hashCode, isEmpty, remove, removeAll, retainAll, size, toArray, toArray
parallelStream, removeIf, stream
forEach
E lower(E e)
null
если нет такого элемента.e
- значение, чтобы соответствоватьe
, или null
если нет такого элементаClassCastException
- если указанный элемент не может быть по сравнению с элементами в настоящий момент в набореNullPointerException
- если указанный элемент является нулем, и этот набор не разрешает нулевые элементыE floor(E e)
null
если нет такого элемента.e
- значение, чтобы соответствоватьe
, или null
если нет такого элементаClassCastException
- если указанный элемент не может быть по сравнению с элементами в настоящий момент в набореNullPointerException
- если указанный элемент является нулем, и этот набор не разрешает нулевые элементыE ceiling(E e)
null
если нет такого элемента.e
- значение, чтобы соответствоватьe
, или null
если нет такого элементаClassCastException
- если указанный элемент не может быть по сравнению с элементами в настоящий момент в набореNullPointerException
- если указанный элемент является нулем, и этот набор не разрешает нулевые элементыE higher(E e)
null
если нет такого элемента.e
- значение, чтобы соответствоватьe
, или null
если нет такого элементаClassCastException
- если указанный элемент не может быть по сравнению с элементами в настоящий момент в набореNullPointerException
- если указанный элемент является нулем, и этот набор не разрешает нулевые элементыE pollFirst()
null
если этот набор пуст.null
если этот набор пустE pollLast()
null
если этот набор пуст.null
если этот набор пустIterator<E> iterator()
NavigableSet<E> descendingSet()
remove
работа), результаты итерации неопределены. У возвращенного набора есть упорядочивание, эквивалентное Collections.reverseOrder
(comparator()). Выражение s.descendingSet().descendingSet()
возвращает представление s
чрезвычайно эквивалентный s
.
Iterator<E> descendingIterator()
descendingSet().iterator()
.NavigableSet<E> subSet(E fromElement, boolean fromInclusive, E toElement, boolean toInclusive)
fromElement
к toElement
. Если fromElement
и toElement
равны, возвращенный набор не пуст если fromInclusive
и toInclusive
оба истина. Возвращенный набор поддерживается этим набором, таким образом, изменения в возвращенном наборе отражаются в этом наборе, и наоборот. Возвращенный набор поддерживает все дополнительные операции присвоения, которые поддерживает этот набор. Возвращенный набор бросит IllegalArgumentException
на попытке вставить элемент вне его диапазона.
fromElement
- низкая конечная точка возвращенного набораfromInclusive
- true
если низкая конечная точка должна быть включена в возвращенное представлениеtoElement
- высокая конечная точка возвращенного набораtoInclusive
- true
если высокая конечная точка должна быть включена в возвращенное представлениеfromElement
, включительно, к toElement
, монопольныйClassCastException
- если fromElement
и toElement
не может быть по сравнению с друг другом, используя компаратор этого набора (или, если у набора нет никакого компаратора, используя естественное упорядочивание). Реализации, но не обязаны, может выдать это исключение если fromElement
или toElement
не может быть по сравнению с элементами в настоящий момент в наборе.NullPointerException
- если fromElement
или toElement
нуль, и этот набор не разрешает нулевые элементыIllegalArgumentException
- если fromElement
больше чем toElement
; или если у этого самого набора есть ограниченный диапазон, и fromElement
или toElement
находится вне границ диапазона.NavigableSet<E> headSet(E toElement, boolean inclusive)
inclusive
истина), toElement
. Возвращенный набор поддерживается этим набором, таким образом, изменения в возвращенном наборе отражаются в этом наборе, и наоборот. Возвращенный набор поддерживает все дополнительные операции присвоения, которые поддерживает этот набор. Возвращенный набор бросит IllegalArgumentException
на попытке вставить элемент вне его диапазона.
toElement
- высокая конечная точка возвращенного набораinclusive
- true
если высокая конечная точка должна быть включена в возвращенное представлениеinclusive
истина), toElement
ClassCastException
- если toElement
не является совместимым с компаратором этого набора (или, если у набора нет никакого компаратора, если toElement
не реализует Comparable
). Реализации, но не обязаны, может выдать это исключение если toElement
не может быть по сравнению с элементами в настоящий момент в наборе.NullPointerException
- если toElement
нуль, и этот набор не разрешает нулевые элементыIllegalArgumentException
- если у этого самого набора есть ограниченный диапазон, и toElement
находится вне границ диапазонаNavigableSet<E> tailSet(E fromElement, boolean inclusive)
inclusive
истина), fromElement
. Возвращенный набор поддерживается этим набором, таким образом, изменения в возвращенном наборе отражаются в этом наборе, и наоборот. Возвращенный набор поддерживает все дополнительные операции присвоения, которые поддерживает этот набор. Возвращенный набор бросит IllegalArgumentException
на попытке вставить элемент вне его диапазона.
fromElement
- низкая конечная точка возвращенного набораinclusive
- true
если низкая конечная точка должна быть включена в возвращенное представлениеfromElement
ClassCastException
- если fromElement
не является совместимым с компаратором этого набора (или, если у набора нет никакого компаратора, если fromElement
не реализует Comparable
). Реализации, но не обязаны, может выдать это исключение если fromElement
не может быть по сравнению с элементами в настоящий момент в наборе.NullPointerException
- если fromElement
нуль, и этот набор не разрешает нулевые элементыIllegalArgumentException
- если у этого самого набора есть ограниченный диапазон, и fromElement
находится вне границ диапазонаSortedSet<E> subSet(E fromElement, E toElement)
Возвращенный набор бросит IllegalArgumentException на попытке вставить элемент вне его диапазона.
Эквивалентный subSet(fromElement, true, toElement, false)
.
subSet
в интерфейсе SortedSet<E>
fromElement
- низкая конечная точка (включительно) возвращенного набораtoElement
- высокая конечная точка (монопольная) из возвращенного набораClassCastException
- если fromElement и toElement не могут быть по сравнению с друг другом, используя компаратор этого набора (или, если у набора нет никакого компаратора, используя естественное упорядочивание). Реализации, но не обязаны, может выдать это исключение, если fromElement или toElement не могут быть по сравнению с элементами в настоящий момент в наборе.NullPointerException
- если fromElement или toElement являются нулем, и этот набор не разрешает нулевые элементыIllegalArgumentException
- если fromElement больше чем toElement; или если у этого самого набора есть ограниченный диапазон, и fromElement или toElement находятся вне границ диапазонаSortedSet<E> headSet(E toElement)
Возвращенный набор бросит IllegalArgumentException на попытке вставить элемент вне его диапазона.
Эквивалентный headSet(toElement, false)
.
headSet
в интерфейсе SortedSet<E>
toElement
- высокая конечная точка (монопольная) из возвращенного набораClassCastException
- если toElement не является совместимым с компаратором этого набора (или, если у набора нет никакого компаратора, если toElement не реализует Comparable
). Реализации, но не обязаны, может выдать это исключение, если toElement не может быть по сравнению с элементами в настоящий момент в наборе.NullPointerException
- если toElement является нулем, и этот набор не разрешает нулевые элементыIllegalArgumentException
- если у этого самого набора есть ограниченный диапазон, и toElement находится вне границ диапазона naSortedSet<E> tailSet(E fromElement)
Возвращенный набор бросит IllegalArgumentException на попытке вставить элемент вне его диапазона.
Эквивалентный tailSet(fromElement, true)
.
tailSet
в интерфейсе SortedSet<E>
fromElement
- низкая конечная точка (включительно) возвращенного набораClassCastException
- если fromElement не является совместимым с компаратором этого набора (или, если у набора нет никакого компаратора, если fromElement не реализует Comparable
). Реализации, но не обязаны, может выдать это исключение, если fromElement не может быть по сравнению с элементами в настоящий момент в наборе.NullPointerException
- если fromElement является нулем, и этот набор не разрешает нулевые элементыIllegalArgumentException
- если у этого самого набора есть ограниченный диапазон, и fromElement находится вне границ диапазона
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92