IComparable Интерфейс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Этот интерфейс накладывает общий порядок на объекты каждого класса, реализующего его.
[Android.Runtime.Register("java/lang/Comparable", "", "Java.Lang.IComparableInvoker")]
[Java.Interop.JavaTypeParameters(new System.String[] { "T" })]
public interface IComparable : Android.Runtime.IJavaObject, IDisposable, Java.Interop.IJavaPeerable
[<Android.Runtime.Register("java/lang/Comparable", "", "Java.Lang.IComparableInvoker")>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "T" })>]
type IComparable = interface
interface IJavaObject
interface IDisposable
interface IJavaPeerable
- Производный
- Атрибуты
- Реализации
Комментарии
Этот интерфейс накладывает общий порядок на объекты каждого класса, реализующего его. Это упорядочение называется естественным упорядочением класса, а метод класса compareTo называется его естественным методом сравнения.
Списки (и массивы) объектов, реализующих этот интерфейс, можно отсортировать автоматически Collections#sort(List) Collections.sort по (и Arrays#sort(Object[]) Arrays.sort). Объекты, реализующие этот интерфейс, можно использовать в качестве ключей в отсортированных картах SortedMap или как элементы в отсортированного набора SortedSet без необходимости указывать компратор сравнения.
Естественное упорядочение для класса C , как утверждается, соответствует равным, если и только если e1.compareTo(e2) == 0 имеет то же логическое значение, что e1.equals(e2) и для каждого e1 класса и e2 класса C. Обратите внимание, что null не является экземпляром любого класса и e.compareTo(null) должен вызываться NullPointerException даже при e.equals(null) возврате false.
Настоятельно рекомендуется (хотя и не обязательно), чтобы естественные упорядочения соответствовали равным. Это так, так как отсортированные наборы (и отсортированные карты) без явных компраторов ведут себя "странно", когда они используются с элементами (или ключами), естественное упорядочение которых несовместимо с равными. В частности, такой отсортированный набор (или отсортированная карта) нарушает общий контракт для набора (или карты), который определяется с точки зрения equals метода.
Например, если один добавляет два ключа a и b такой, что (!a.equals(b) && a.compareTo(b) == 0) в отсортированный набор, который не использует явный компратор, вторая add операция возвращает значение false (и размер отсортированного набора не увеличивается), так как a и b эквивалентно с точки зрения отсортированного набора.
Практически все Java основные классы, реализующие Comparable естественные упорядочения, которые соответствуют равным. Одним из исключений является java.math.BigDecimaljava.math.BigDecimal#compareTo естественное упорядочение BigDecimal объектов с равными числовыми значениями и различными представлениями (например, 4.0 и 4.00). Чтобы java.math.BigDecimal#equals BigDecimal.equals() вернуть значение true, представление и числовое значение двух BigDecimal объектов должно совпадать.
Для математического наклона отношение , определяющее естественное упорядочение для заданного класса C:
{@code
{(x, y) such that x.compareTo(y) <= 0}.
}
Ниже приведена цитата для этого общего порядка:
{@code
{(x, y) such that x.compareTo(y) == 0}.
}
Он следует сразу же из контракта для compareTo того, чтобы кворот является отношением эквивалентности поC, и что естественное упорядочение является общим порядком.C Когда мы говорим, что естественное упорядочение класса согласуется с равными, мы имеем в виду, что кворот для естественного упорядочения — это отношение эквивалентности, определенное методом класса Object#equals(Object) equals(Object) :
{(x, y) such that x.equals(y)}.
Другими словами, когда естественное упорядочение класса соответствует равным, классы эквивалентности, определенные отношением equals эквивалентности метода, и классы эквивалентности, определенные квалиентным compareTo методом, совпадают.
Этот интерфейс является членом платформы коллекций Java.
Добавлено в версии 1.2.
Java документации по java.lang.Comparable.
Части этой страницы — это изменения на основе работы, созданной и общей Project и используемых в соответствии с условиями, описанными в разделе "".
Свойства
| Имя. | Описание |
|---|---|
| Handle |
Возвращает значение JNI базового объекта Android. (Унаследовано от IJavaObject) |
| JniIdentityHashCode |
Возвращает значение |
| JniManagedPeerState |
Состояние управляемого однорангового узла. (Унаследовано от IJavaPeerable) |
| JniObjectReferenceControlBlock |
Этот интерфейс накладывает общий порядок на объекты каждого класса, реализующего его. (Унаследовано от IJavaPeerable) |
| JniPeerMembers |
Поддержка доступа к членам и вызовов. (Унаследовано от IJavaPeerable) |
| PeerReference |
JniObjectReference Возвращает экземпляр объекта в оболочке Java. (Унаследовано от IJavaPeerable) |
Методы
| Имя. | Описание |
|---|---|
| CompareTo(Object) |
Сравнивает этот объект с указанным объектом для заказа. |
| Disposed() |
Вызывается при удалении экземпляра. (Унаследовано от IJavaPeerable) |
| DisposeUnlessReferenced() |
Если нет невыполненных ссылок на этот экземпляр, то вызывается |
| Finalized() |
Вызывается при завершении экземпляра. (Унаследовано от IJavaPeerable) |
| SetJniIdentityHashCode(Int32) |
Задайте значение, возвращаемое |
| SetJniManagedPeerState(JniManagedPeerStates) |
Этот интерфейс накладывает общий порядок на объекты каждого класса, реализующего его. (Унаследовано от IJavaPeerable) |
| SetPeerReference(JniObjectReference) |
Задайте значение, возвращаемое |
| UnregisterFromRuntime() |
Отмените регистрацию этого экземпляра, чтобы среда выполнения не возвращала ее из будущих Java.Interop.JniRuntime+JniValueManager.PeekValue вызовов. (Унаследовано от IJavaPeerable) |
Методы расширения
| Имя. | Описание |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Возвращает имя JNI типа экземпляра |
| JavaAs<TResult>(IJavaPeerable) |
Попробуйте принуждать к типу |
| JavaCast<TResult>(IJavaObject) |
Выполняет преобразование типа, проверяемого средой выполнения Android. |
| JavaCast<TResult>(IJavaObject) |
Этот интерфейс накладывает общий порядок на объекты каждого класса, реализующего его. |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Попробуйте принуждать к типу |