String.CompareTo(String) Méthode

[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

Paramètres

Retours

la valeur 0 si la chaîne d’argument est égale à cette chaîne ; une valeur inférieure à 0 si cette chaîne est lexicographiquement inférieure à l’argument de chaîne ; et une valeur supérieure à 0 si cette chaîne est lexicographiquement supérieure à l’argument de chaîne.

Attributs

RegisterAttribute

Exceptions

Remarques

Compare deux chaînes lexicographiquement. La comparaison est basée sur la valeur Unicode de chaque caractère dans les chaînes. La séquence de caractères représentée par cet String objet est comparée lexicographiquement à la séquence de caractères représentée par la chaîne d’argument. Le résultat est un entier négatif si cet String objet lexicographique précède la chaîne d’argument. Le résultat est un entier positif si cet String objet lexicographique suit la chaîne d’argument. Le résultat est égal à zéro si les chaînes sont égales ; compareTo retourne 0 exactement quand la #equals(Object) méthode retournerait true.

Il s’agit de la définition de l’ordre lexicographique. Si deux chaînes sont différentes, elles ont des caractères différents à un index qui est un index valide pour les deux chaînes, ou leurs longueurs sont différentes, ou les deux. S’ils ont des caractères différents à une ou plusieurs positions d’index, laissez k être le plus petit de tels index ; puis la chaîne dont le caractère à la position k a la plus petite valeur, telle que déterminée à l’aide de l’opérateur < , lexicographiquement précède l’autre chaîne. Dans ce cas, compareTo retourne la différence entre les deux valeurs de caractères à la position k dans les deux chaînes , autrement dit, la valeur : <blockquote>

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

</blockquote> S’il n’existe aucune position d’index à laquelle ils diffèrent, la chaîne laxicographique plus courte précède la plus longue chaîne. Dans ce cas, compareTo retourne la différence entre les longueurs des chaînes , c’est-à-dire la valeur : <blockquote>

this.length()-anotherString.length()

</blockquote>

Pour obtenir une comparaison de chaînes plus fine, reportez-vous à java.text.Collator.

Java documentation pour java.lang.String.compareTo(java.lang.String).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.