IComparable.CompareTo(Object) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Compara este objeto con el objeto especificado para el orden.
[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
Parámetros
- o
- Object
objeto que se va a comparar.
Devoluciones
un entero negativo, cero o un entero positivo, ya que este objeto es menor, igual o mayor que el objeto especificado.
- Atributos
Comentarios
Compara este objeto con el objeto especificado para el orden. Devuelve un entero negativo, cero o un entero positivo, ya que este objeto es menor, igual o mayor que el objeto especificado.
El implementador debe asegurarse sgn(x.compareTo(y)) == -sgn(y.compareTo(x))
de todo x
y y
. (Esto implica que x.compareTo(y)
debe iniciar una excepción iff y.compareTo(x)
produce una excepción).
El implementador también debe asegurarse de que la relación sea transitiva: (x.compareTo(y) > 0 && y.compareTo(z) > 0)
implica x.compareTo(z) > 0
.
Por último, el implementador debe asegurarse de que x.compareTo(y)==0
implica que sgn(x.compareTo(z)) == sgn(y.compareTo(z))
, para todo z
.
Se recomienda encarecidamente, pero no es estrictamente necesario que (x.compareTo(y)==0) == (x.equals(y))
. Por lo general, cualquier clase que implemente la Comparable
interfaz e infrinja esta condición debería indicar claramente este hecho. El lenguaje recomendado es "Nota: esta clase tiene una ordenación natural que es incoherente con iguales".
En la descripción anterior, la expresión)
de notación sgn(
designa la función de signo matemático, que se define para devolver una de -1
, 0
o 1
según si el valor de la expresión es negativo, cero o positivo, respectivamente.
Documentación de Java para java.lang.Comparable.compareTo(T)
.
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.