IComparable.CompareTo(Object) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Сравнивает этот объект с указанным объектом для заказа.
[Android.Runtime.Register("compareTo", "(Ljava/lang/Object;)I", "GetCompareTo_Ljava_lang_Object_Handler:Java.Lang.IComparableInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public int CompareTo (Java.Lang.Object o);
[<Android.Runtime.Register("compareTo", "(Ljava/lang/Object;)I", "GetCompareTo_Ljava_lang_Object_Handler:Java.Lang.IComparableInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member CompareTo : Java.Lang.Object -> int
Параметры
- o
- Object
объект для сравнения.
Возвращаемое значение
отрицательное целое число, ноль или положительное целое число, так как этот объект меньше, равно или больше указанного объекта.
- Атрибуты
Комментарии
Сравнивает этот объект с указанным объектом для заказа. Возвращает отрицательное целое число, ноль или положительное целое число, так как этот объект меньше, равно или больше указанного объекта.
Реализутель должен обеспечить sgn(x.compareTo(y)) == -sgn(y.compareTo(x))
все x
и y
. (Это означает, что x.compareTo(y)
должен вызывать y.compareTo(x)
исключение.)
Реализация также должна обеспечить транзитивную связь: (x.compareTo(y) > 0 && y.compareTo(z) > 0)
подразумевает x.compareTo(z) > 0
.
Наконец, реализация должна обеспечить, что подразумевает, что x.compareTo(y)==0
sgn(x.compareTo(z)) == sgn(y.compareTo(z))
для всех z
.
Настоятельно рекомендуется, но не строго обязательно.(x.compareTo(y)==0) == (x.equals(y))
Как правило, любой класс, реализующий Comparable
интерфейс и нарушающий это условие, должен четко указывать на этот факт. Рекомендуемый язык — "Примечание. Этот класс имеет естественное упорядочение, несовместимое с равными".
В описании заготовки выражение нотации sgn(
обозначает функцию математического знака, которая определяется для возврата одного из -1
, 0
или 1
в соответствии с тем, является ли значение выражения отрицательным, нулевым или положительным соответственно.)
Документация по Java для java.lang.Comparable.compareTo(T)
.
Части этой страницы — это изменения на основе работы, созданной и общей проектом с открытым исходным кодом Android и используемой в соответствии с условиями, описанными в лицензии Creative Commons 2.5 Attribution.