IComparable.CompareTo(Object) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Compara esse objeto com o objeto especificado para a ordem.
[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 -> intParâmetros
- o
- Object
o objeto a ser comparado.
Retornos
um inteiro negativo, zero ou um inteiro positivo, pois esse objeto é menor, igual ou maior que o objeto especificado.
- Atributos
Comentários
Compara esse objeto com o objeto especificado para a ordem. Retorna um inteiro negativo, zero ou um inteiro positivo à medida que esse objeto é menor, igual ou maior que o objeto especificado.
O implementador deve garantir sgn(x.compareTo(y)) == -sgn(y.compareTo(x)) para todos x e y. (Isso implica que x.compareTo(y) deve lançar uma exceção e y.compareTo(x) lançar uma exceção.)
O implementador também deve garantir que a relação seja transitiva: (x.compareTo(y) > 0 && y.compareTo(z) > 0) implica x.compareTo(z) > 0.
Finalmente, o implementador deve garantir que x.compareTo(y)==0 isso implica que sgn(x.compareTo(z)) == sgn(y.compareTo(z)), para todos z.
É fortemente recomendado, mas não estritamente exigido que (x.compareTo(y)==0) == (x.equals(y)). De um modo geral, qualquer classe que implemente a Comparable interface e viole essa condição deve indicar claramente esse fato. A linguagem recomendada é "Nota: esta classe tem uma ordem natural que é inconsistente com iguais."
Na descrição acima, a expressão) de notação sgn(designa a função de signo matemático, que é definida para retornar um de -1, 0ou 1 de acordo com se o valor da expressão é negativo, zero ou positivo, respectivamente.
Documentação Java para java.lang.Comparable.compareTo(T).
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usado de acordo com os termos descritos na Creative Commons 2.5 Attribution License.