ISortedSet Интерфейс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Это Set
также обеспечивает общее упорядочение элементов.
[Android.Runtime.Register("java/util/SortedSet", "", "Java.Util.ISortedSetInvoker")]
[Java.Interop.JavaTypeParameters(new System.String[] { "E" })]
public interface ISortedSet : IDisposable, Java.Interop.IJavaPeerable, Java.Util.ISet
[<Android.Runtime.Register("java/util/SortedSet", "", "Java.Util.ISortedSetInvoker")>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "E" })>]
type ISortedSet = interface
interface ISet
interface ICollection
interface IIterable
interface IJavaObject
interface IDisposable
interface IJavaPeerable
- Производный
- Атрибуты
- Реализации
Комментарии
Это Set
также обеспечивает общее упорядочение элементов. Элементы упорядочены с помощью Comparator
их аналогичного естественного упорядочения или обычно предоставленным при сортировке времени создания. Итератор набора проходит по набору в порядке элемента по возрастанию. Для использования упорядочения предоставляются несколько дополнительных операций. (Этот интерфейс является набором аналога SortedMap
.)
Все элементы, вставляемые в отсортированный набор, должны реализовывать Comparable
интерфейс (или приниматься указанным компратором). Кроме того, все такие элементы e1
должны быть взаимосопоставимыми: e1.compareTo(e2)
(илиcomparator.compare(e1, e2)
) не должно вызываться ClassCastException
для элементов и e2
в отсортированного набора. Попытки нарушить это ограничение приведет к ClassCastException
возникновению вызова метода или конструктора.
Обратите внимание, что порядок, поддерживаемый сортируемым набором (независимо от того, предоставляется ли явный компратор) должен быть согласован с равными, если отсортированный набор предназначен для правильной реализации Set
интерфейса. (См Comparable
. интерфейс или Comparator
интерфейс для точного определения соответствия равным.) Это так, потому что Set
интерфейс определен с точки зрения equals
операции, но отсортированный набор выполняет все сравнения элементов с помощью его compareTo
метода (или compare
), поэтому два элемента, которые считаются равными этим методом, с точки зрения отсортированного набора, равны. Поведение отсортированного набора четко определяется , даже если его порядок не согласуется с равными; он просто не соответствует общему контракту Set
интерфейса.
Все классы реализации с сортировкой общего назначения должны предоставлять четыре "стандартных" конструктора: 1) Конструктор void (без аргументов), который создает пустой отсортированный набор, отсортированный в соответствии с естественным упорядочением его элементов. 2) Конструктор с одним аргументом типа Comparator
, который создает пустой отсортированный набор, отсортированный в соответствии с указанным сравнивателем. 3) Конструктор с одним аргументом типа Collection
, который создает новый отсортированный набор с теми же элементами, что и его аргумент, отсортированный в соответствии с естественным упорядочением элементов. 4) Конструктор с одним аргументом типа SortedSet
, который создает новый отсортированный набор с теми же элементами и таким же порядком, что и входной отсортированный набор. Невозможно применить эту рекомендацию, так как интерфейсы не могут содержать конструкторы.
Примечание. Несколько методов возвращают подмножества с ограниченными диапазонами. Такие диапазоны являются полуоткрытыми, то есть включают их низкую конечную точку, но не их высокую конечную точку (где применимо). Если вам нужен закрытый диапазон (который включает обе конечные точки), а тип элемента позволяет вычислять преемник заданного значения, просто запрашивать подранг отlowEndpoint
.successor(highEndpoint)
Например, предположим, что s
это отсортированный набор строк. Следующая идиома получает представление, содержащее все строки из low
high
, включительноs
:
SortedSet<String> sub = s.subSet(low, high+"\0");
Аналогичный метод можно использовать для создания открытого диапазона (который не содержит ни конечную точку). Следующая идиома получает представление, содержащее все строки s
из low
high
, в которые входят , эксклюзивные:
SortedSet<String> sub = s.subSet(low+"\0", high);
Этот интерфейс является членом Платформы коллекций Java.
Добавлено в версии 1.2.
Документация по Java для java.util.SortedSet
.
Части этой страницы — это изменения на основе работы, созданной и общей проектом с открытым исходным кодом Android и используемой в соответствии с условиями, описанными в лицензии Creative Commons 2.5 Attribution.
Свойства
Handle |
Возвращает значение JNI базового объекта Android. (Унаследовано от IJavaObject) |
IsEmpty |
Возвращает значение true, если этот набор не содержит элементов. (Унаследовано от ISet) |
JniIdentityHashCode |
Возвращает значение |
JniManagedPeerState |
Состояние управляемого однорангового узла. (Унаследовано от IJavaPeerable) |
JniPeerMembers |
Поддержка доступа к членам и вызовов. (Унаследовано от IJavaPeerable) |
PeerReference |
JniObjectReference Возвращает экземпляр объекта Java в оболочке. (Унаследовано от IJavaPeerable) |
Методы
Add(Object) |
Добавляет указанный элемент в этот набор, если он еще не присутствует (необязательная операция). (Унаследовано от ISet) |
AddAll(ICollection) |
Добавляет все элементы указанной коллекции в этот набор, если они еще не присутствуют (необязательной операции). (Унаследовано от ISet) |
Clear() |
Удаляет все элементы из этого набора (необязательной операции). (Унаследовано от ISet) |
Comparator() |
Возвращает компратор, используемый для упорядочивания элементов в этом наборе, или |
Contains(Object) |
Возвращает, |
ContainsAll(ICollection) |
Возвращает, |
Disposed() |
Вызывается при удалении экземпляра. (Унаследовано от IJavaPeerable) |
DisposeUnlessReferenced() |
Если нет невыполненных ссылок на этот экземпляр, то вызывается |
Equals(Object) |
Сравнивает указанный объект с этим набором для равенства. (Унаследовано от ISet) |
Finalized() |
Вызывается при завершении экземпляра. (Унаследовано от IJavaPeerable) |
First() |
Возвращает первый (самый низкий) элемент в данный момент в этом наборе. |
ForEach(IConsumer) |
Выполняет заданное действие для каждого элемента |
GetHashCode() |
Возвращает хэш-значение кода для этого набора. (Унаследовано от ISet) |
HeadSet(Object) |
Возвращает представление части этого набора, элементы которого строго меньше |
Iterator() |
Возвращает итератор над элементами этого набора. (Унаследовано от ISet) |
Last() |
Возвращает последний (самый высокий) элемент в данный момент в этом наборе. |
Remove(Object) |
Удаляет указанный элемент из этого набора, если он присутствует (необязательно). (Унаследовано от ISet) |
RemoveAll(ICollection) |
Удаляет из этого набора все его элементы, содержащиеся в указанной коллекции (необязательной операции). (Унаследовано от ISet) |
RemoveIf(IPredicate) |
Удаляет все элементы этой коллекции, удовлетворяющие заданному предикату. (Унаследовано от ICollection) |
RetainAll(ICollection) |
Сохраняет только элементы этого набора, содержащиеся в указанной коллекции (необязательной операции). (Унаследовано от ISet) |
SetJniIdentityHashCode(Int32) |
Задайте значение, возвращаемое |
SetJniManagedPeerState(JniManagedPeerStates) |
Это |
SetPeerReference(JniObjectReference) |
Задайте значение, возвращаемое |
Size() |
Возвращает количество элементов в этом наборе (его кратность). (Унаследовано от ISet) |
Spliterator() |
|
SubSet(Object, Object) |
Возвращает представление части этого набора, элементы которого варьируются от |
TailSet(Object) |
Возвращает представление части этого набора, элементы которого больше или равно |
ToArray() |
Возвращает массив, содержащий все элементы в этом наборе. (Унаследовано от ISet) |
ToArray(IIntFunction) |
Возвращает массив, содержащий все элементы в этой коллекции, используя предоставленную |
ToArray(Object[]) |
Возвращает массив, содержащий все элементы в этом наборе; Тип среды выполнения возвращаемого массива — это тип указанного массива. (Унаследовано от ISet) |
UnregisterFromRuntime() |
Отмените регистрацию этого экземпляра, чтобы среда выполнения не возвращала ее из будущих Java.Interop.JniRuntime+JniValueManager.PeekValue вызовов. (Унаследовано от IJavaPeerable) |
Явные реализации интерфейса
IIterable.Spliterator() |
|
Методы расширения
JavaCast<TResult>(IJavaObject) |
Выполняет преобразование типа, проверяемого средой выполнения Android. |
JavaCast<TResult>(IJavaObject) |
Это |
GetJniTypeName(IJavaPeerable) |
Это |
ToEnumerable(IIterable) |
Это |
ToEnumerable<T>(IIterable) |
Это |