Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

String.compareTo — comparaison lexicographique

String.compareTo compare les chaînes de manière lexicographique. Le signe du résultat détermine l’ordre ; zéro signifie que leur contenu est égal.

Version : Java SE 21; repository runtime, production runtime not attested

Syntaxe

public int compareTo(String anotherString)
// Usage: int result = left.compareTo(right);

String.compareTo renvoie un int : un résultat négatif signifie que la chaîne de gauche précède celle de droite ; un résultat positif signifie qu’elle la suit. Zéro correspond à l’égalité selon equals.

La comparaison tient compte de la casse et utilise les valeurs des unités de code UTF-16 (char), et non des règles linguistiques. Le résultat est la différence entre les premières unités différentes ; si une chaîne est le préfixe de l’autre, il s’agit de la différence de longueur. Ne supposez pas que le résultat vaut uniquement -1, 0 ou 1 : vérifiez son signe.

Un argument null provoque une NullPointerException. Utilisez Collator pour les comparaisons dépendant de la langue.

Exemples

public class Main {
    public static void main(String[] args) {
        System.out.println("cat".compareTo("car"));
        System.out.println("car".compareTo("cart"));
        System.out.println("cat".compareTo("cat"));
        System.out.println("A".compareTo("a") < 0);
    }
}

Résultat

2
-1
0
true

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources