Язык

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

Возвращает значение java.lang.System.identityHashCode() для упаковаемого экземпляра.

(Унаследовано от IJavaPeerable)
JniManagedPeerState

Состояние управляемого однорангового узла.

(Унаследовано от IJavaPeerable)
JniObjectReferenceControlBlock

Этот интерфейс накладывает общий порядок на объекты каждого класса, реализующего его.

(Унаследовано от IJavaPeerable)
JniPeerMembers

Поддержка доступа к членам и вызовов.

(Унаследовано от IJavaPeerable)
PeerReference

JniObjectReference Возвращает экземпляр объекта в оболочке Java.

(Унаследовано от IJavaPeerable)

Методы

Имя. Описание
CompareTo(Object)

Сравнивает этот объект с указанным объектом для заказа.

Disposed()

Вызывается при удалении экземпляра.

(Унаследовано от IJavaPeerable)
DisposeUnlessReferenced()

Если нет невыполненных ссылок на этот экземпляр, то вызывается Dispose(); в противном случае ничего не делает.

(Унаследовано от IJavaPeerable)
Finalized()

Вызывается при завершении экземпляра.

(Унаследовано от IJavaPeerable)
SetJniIdentityHashCode(Int32)

Задайте значение, возвращаемое JniIdentityHashCode.

(Унаследовано от IJavaPeerable)
SetJniManagedPeerState(JniManagedPeerStates)

Этот интерфейс накладывает общий порядок на объекты каждого класса, реализующего его.

(Унаследовано от IJavaPeerable)
SetPeerReference(JniObjectReference)

Задайте значение, возвращаемое PeerReference.

(Унаследовано от IJavaPeerable)
UnregisterFromRuntime()

Отмените регистрацию этого экземпляра, чтобы среда выполнения не возвращала ее из будущих Java.Interop.JniRuntime+JniValueManager.PeekValue вызовов.

(Унаследовано от IJavaPeerable)

Методы расширения

Имя. Описание
GetJniTypeName(IJavaPeerable)

Возвращает имя JNI типа экземпляра self.

JavaAs<TResult>(IJavaPeerable)

Попробуйте принуждать к типуself, проверяяTResult, является ли приведение допустимым на стороне Java.

JavaCast<TResult>(IJavaObject)

Выполняет преобразование типа, проверяемого средой выполнения Android.

JavaCast<TResult>(IJavaObject)

Этот интерфейс накладывает общий порядок на объекты каждого класса, реализующего его.

TryJavaCast<TResult>(IJavaPeerable, TResult)

Попробуйте принуждать к типуself, проверяяTResult, является ли приведение допустимым на стороне Java.

Применяется к