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.compareTo(e2)
(или comparator.compare(e1, e2)
) не должны вызывать исключение ClassCastException
для каких-либо элементов e1
и e2
в отсортированных наборах. Попытки нарушить это ограничение приведут к вызову метода или конструктора, вызывающего ошибку ClassCastException
.
Обратите внимание, что порядок, поддерживаемый отсортированных набором (независимо от того, предоставлен ли явный компаратор), должен быть согласован с равенствами , если отсортированный набор должен правильно реализовать Set
интерфейс. (Точное Comparable
определение соответствия с равенствами см. в интерфейсе или Comparator
интерфейсе.) Это связано с тем, что Set
интерфейс определяется с точки зрения equals
операции, но отсортированный набор выполняет все сравнения элементов с помощью метода compareTo
(или compare
), поэтому два элемента, которые считаются равными этим методом, с точки зрения отсортированного набора, равны. Поведение отсортированного набора четко определено, даже если его порядок не соответствует равенствам; он просто не подчиняется общему контракту Set
интерфейса.
Все классы реализации отсортированных наборов общего назначения должны предоставлять четыре "стандартных" конструктора: 1) конструктор void (без аргументов), который создает пустой отсортированный набор, отсортированный в соответствии с естественным порядком его элементов. 2) Конструктор с одним аргументом типа Comparator
, который создает пустой отсортированный набор, отсортированный в соответствии с указанным компаратором. 3) Конструктор с одним аргументом типа Collection
, который создает новый отсортированный набор с теми же элементами, что и его аргумент, отсортированный в соответствии с естественным порядком элементов. 4) Конструктор с одним аргументом типа SortedSet
, который создает новый отсортированный набор с теми же элементами и тем же порядком, что и входной отсортированный набор. Применить эту рекомендацию невозможно, так как интерфейсы не могут содержать конструкторы.
Примечание. Несколько методов возвращают подмножества с ограниченными диапазонами. Такие диапазоны являются полуоткрытыми, т. е. включают низкую конечную точку, но не высокую конечную точку (если применимо). Если требуется закрытый диапазон (который включает обе конечные точки), а тип элемента позволяет вычислять преемник заданного значения, просто запросите поддиапзон из lowEndpoint
в successor(highEndpoint)
. Например, предположим, что s
это отсортированный набор строк. Следующая идиома получает представление, содержащее все строки в s
от low
до high
включительно:
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
.
Части этой страницы являются изменениями, основанными на работе, созданной и совместно используемой проектом и используемой в соответствии с условиями, Creative Commons 2.5 Attribution License Creative Commons 2.5 Attribution License.
Свойства
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) |
Объект , |