String.CompareTo(String) Método

Definição

Namespace:

Java.Lang

Assembly:

Mono.Android.dll

Compara duas cadeias de caracteres lexicograficamente.

[Android.Runtime.Register("compareTo", "(Ljava/lang/String;)I", "")]
public int CompareTo(string anotherString);

[<Android.Runtime.Register("compareTo", "(Ljava/lang/String;)I", "")>]
member this.CompareTo : string -> int

Parâmetros

anotherString

String

a String ser comparado.

Retornos

Int32

o valor 0 se a cadeia de caracteres de argumento for igual a essa cadeia de caracteres; um valor menor do que 0 se essa cadeia de caracteres for lexicograficamente menor que o argumento de cadeia de caracteres; e um valor maior do que 0 se essa cadeia de caracteres for lexicograficamente maior que o argumento de cadeia de caracteres.

Atributos

RegisterAttribute

Exceções

NullPointerException

se string for null.

Comentários

Compara duas cadeias de caracteres lexicograficamente. A comparação é baseada no valor Unicode de cada caractere nas cadeias de caracteres. A sequência de caracteres representada por esse String objeto é comparada lexicograficamente com a sequência de caracteres representada pela cadeia de caracteres de argumento. O resultado será um inteiro negativo se esse String objeto preceder lexicograficamente a cadeia de caracteres de argumento. O resultado será um inteiro positivo se esse String objeto seguir lexicograficamente a cadeia de caracteres de argumento. O resultado será zero se as cadeias de caracteres forem iguais; compareTo retorna 0 exatamente quando o #equals(Object) método retornaria true.

Essa é a definição de ordenação lexicográfica. Se duas cadeias de caracteres forem diferentes, elas terão caracteres diferentes em algum índice que seja um índice válido para ambas as cadeias de caracteres ou seus comprimentos serão diferentes ou ambos. Se eles tiverem caracteres diferentes em uma ou mais posições de índice, vamos ser o menor índice desse tipo; em seguida, a cadeia de caracteres cujo caractere na posição k tem o valor menor, conforme determinado usando o < operador, precede lexicograficamente a outra cadeia de caracteres. Nesse caso, compareTo retorna a diferença dos dois valores de caractere na posição k nas duas cadeias de caracteres, ou seja, o valor: <blockquote>

this.charAt(k)-anotherString.charAt(k)

</blockquote> Se não houver nenhuma posição de índice na qual eles diferem, a cadeia de caracteres mais curta precede lexicograficamente a cadeia de caracteres mais longa. Nesse caso, compareTo retorna a diferença dos comprimentos das cadeias de caracteres , ou seja, o valor: <blockquote>

this.length()-anotherString.length()

</blockquote>

Para comparação de cadeia de caracteres mais refinada, consulte java.text.Collator.

Documentação Java para java.lang.String.compareTo(java.lang.String).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usadas de acordo com os termos descritos na Licença de Atribuição Creative Commons 2.5.