java.util

Соедините интерфейсом с NavigableSet <E>

Введите Параметры:

E - тип элементов сохраняется этим набором

Все Суперинтерфейсы:

Набор <E>, Повторяемый <E>, Набор <E>, SortedSet <E>

Все Известные Классы с реализацией:

ConcurrentSkipListSet, TreeSet

public interface NavigableSet<E>
extends SortedSet<E>

A 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.

С тех пор:

1.6

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
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.

Методы, наследованные от интерфейса java.util. SortedSet

comparator, first, last

Методы, наследованные от интерфейса java.util. Набор

add, addAll, clear, contains, containsAll, equals, hashCode, isEmpty, remove, removeAll, retainAll, size, toArray, toArray

Деталь метода

ниже

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 - если указанный элемент является нулем, и этот набор не разрешает нулевые элементы

pollFirst

E pollFirst()

Получает и удаляет первый (самый низкий) элемент, или возвраты null если этот набор пуст.

Возвраты:

первый элемент, или null если этот набор пуст

pollLast

E pollLast()

Получает и удаляет последний (самый высокий) элемент, или возвраты null если этот набор пуст.

Возвраты:

последний элемент, или null если этот набор пуст

iterator

Iterator<E> iterator()

Возвращает iterator по элементам в этом наборе, в порядке возрастания.

Определенный:

iterator в интерфейсе Collection<E>

Определенный:

iterator в интерфейсе Iterable<E>

Определенный:

iterator в интерфейсе Set<E>

Возвраты:

iterator по элементам в этом наборе, в порядке возрастания

descendingSet

NavigableSet<E> descendingSet()

Возвращает представление обратного порядка элементов, содержавшихся в этом наборе. Набор убывания поддерживается этим набором, так изменения к набору отражаются в наборе убывания, и наоборот. Если любой набор изменяется, в то время как итерация по любому набору происходит (кроме через собственный iterator's remove работа), результаты итерации неопределены.

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

Возвраты:

представление обратного порядка этого набора

descendingIterator

Iterator<E> descendingIterator()

Возвращает iterator по элементам в этом наборе, в порядке убывания. Эквивалентный в действительности descendingSet().iterator().

Возвраты:

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 находится вне границ диапазона

tailSet

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)

Возвращает представление части этого набора, элементы которого колеблются от fromElement, включительно, к toElement, монопольному. (Если fromElement и toElement равны, возвращенный набор пуст.) Возвращенный набор поддерживается этим набором, таким образом, изменения в возвращенном наборе отражаются в этом наборе, и наоборот. Возвращенный набор поддерживает все дополнительные операции присвоения, которые поддерживает этот набор.

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

Эквивалентный subSet(fromElement, true, toElement, false).

Определенный:

subSet в интерфейсе SortedSet<E>

Параметры:

fromElement - низкая конечная точка (включительно) возвращенного набора

toElement - высокая конечная точка (монопольная) из возвращенного набора

Возвраты:

представление части этого набора, элементы которого колеблются от fromElement, включительно, к toElement, монопольному

Броски:

ClassCastException - если fromElement и toElement не могут быть по сравнению с друг другом, используя компаратор этого набора (или, если у набора нет никакого компаратора, используя естественное упорядочивание). Реализации, но не обязаны, может выдать это исключение, если fromElement или toElement не могут быть по сравнению с элементами в настоящий момент в наборе.

NullPointerException - если fromElement или toElement являются нулем, и этот набор не разрешает нулевые элементы

IllegalArgumentException - если fromElement больше чем toElement; или если у этого самого набора есть ограниченный диапазон, и fromElement или toElement находятся вне границ диапазона

гарнитура

SortedSet<E> headSet(E toElement)

Возвращает представление части этого набора, элементы которого являются строго меньше чем toElement. Возвращенный набор поддерживается этим набором, таким образом, изменения в возвращенном наборе отражаются в этом наборе, и наоборот. Возвращенный набор поддерживает все дополнительные операции присвоения, которые поддерживает этот набор.

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

Эквивалентный headSet(toElement, false).

Определенный:

headSet в интерфейсе SortedSet<E>

Параметры:

toElement - высокая конечная точка (монопольная) из возвращенного набора

Возвраты:

представление части этого набора, элементы которого являются строго меньше чем toElement

Броски:

ClassCastException - если toElement не является совместимым с компаратором этого набора (или, если у набора нет никакого компаратора, если toElement не реализует Comparable). Реализации, но не обязаны, может выдать это исключение, если toElement не может быть по сравнению с элементами в настоящий момент в наборе.

NullPointerException - если toElement является нулем, и этот набор не разрешает нулевые элементы

IllegalArgumentException - если у этого самого набора есть ограниченный диапазон, и toElement находится вне границ диапазона na

tailSet

SortedSet<E> tailSet(E fromElement)

Возвращает представление части этого набора, элементы которого больше чем или равны fromElement. Возвращенный набор поддерживается этим набором, таким образом, изменения в возвращенном наборе отражаются в этом наборе, и наоборот. Возвращенный набор поддерживает все дополнительные операции присвоения, которые поддерживает этот набор.

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

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

Определенный:

tailSet в интерфейсе SortedSet<E>

Параметры:

fromElement - низкая конечная точка (включительно) возвращенного набора

Возвраты:

представление части этого набора, элементы которого больше чем или равны fromElement

Броски:

ClassCastException - если fromElement не является совместимым с компаратором этого набора (или, если у набора нет никакого компаратора, если fromElement не реализует Comparable). Реализации, но не обязаны, может выдать это исключение, если fromElement не может быть по сравнению с элементами в настоящий момент в наборе.

NullPointerException - если fromElement является нулем, и этот набор не разрешает нулевые элементы

IllegalArgumentException - если у этого самого набора есть ограниченный диапазон, и fromElement находится вне границ диапазона