String.CompareTo(String) Método

Definición

Espacio de nombres:

Java.Lang

Ensamblado:

Mono.Android.dll

Compara dos cadenas lexicográficamente.

[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

que String se va a comparar.

Devoluciones

Int32

valor 0 si la cadena del argumento es igual a esta cadena; un valor menor que 0 si esta cadena es lexicográficamente menor que el argumento string; y un valor mayor que 0 si esta cadena es lexicográficamente mayor que el argumento string.

Atributos

RegisterAttribute

Excepciones

NullPointerException

si string es null.

Comentarios

Compara dos cadenas lexicográficamente. La comparación se basa en el valor Unicode de cada carácter de las cadenas. La secuencia de caracteres representada por este String objeto se compara lexicográficamente con la secuencia de caracteres representada por la cadena de argumentos. El resultado es un entero negativo si este String objeto lexicográficamente precede a la cadena de argumento. El resultado es un entero positivo si este String objeto lexicográficamente sigue la cadena de argumento. El resultado es cero si las cadenas son iguales; compareTo devuelve 0 exactamente cuando el #equals(Object) método devolvería true.

Esta es la definición de ordenación lexicográfica. Si dos cadenas son diferentes, tienen caracteres diferentes en algún índice que es un índice válido para ambas cadenas, o sus longitudes son diferentes o ambas. Si tienen caracteres diferentes en una o más posiciones de índice, deje que k sea el índice más pequeño; a continuación, la cadena cuyo carácter en la posición k tiene el valor más pequeño, determinado por el < operador , lexicográficamente precede a la otra cadena. En este caso, compareTo devuelve la diferencia de los dos valores de caracteres en la posición k de la dos cadena; es decir, el valor: <blockquote>

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

</blockquote> Si no hay ninguna posición de índice en la que difieren, la cadena más corta lexicográficamente precede a la cadena más larga. En este caso, compareTo devuelve la diferencia de las longitudes de las cadenas; es decir, el valor: <blockquote>

this.length()-anotherString.length()

</blockquote>

Para obtener una comparación de cadenas más detallada, consulte java.text.Collator.

Java documentación para java.lang.String.compareTo(java.lang.String).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.