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

CKTIS / Java

String.equalsIgnoreCase — comparaison sans distinction entre majuscules et minuscules

String.equalsIgnoreCase compare des chaînes sans distinguer les majuscules des minuscules, indépendamment des paramètres régionaux. La méthode renvoie un boolean.

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

Syntaxe

public boolean equalsIgnoreCase(String anotherString)

String.equalsIgnoreCase exige que les chaînes aient la même longueur et que leurs points de code Unicode correspondants concordent. Les points concordent s’ils sont identiques ou si Character.toLowerCase(Character.toUpperCase(int)) produit le même résultat.

Un argument null donne false ; appeler la méthode sur un récepteur null déclenche une NullPointerException. Contrairement à cette méthode, equals distingue les majuscules des minuscules.

La méthode ne tient pas compte des paramètres régionaux ; utilisez Collator pour les comparaisons dépendantes de la langue. Elle n’assimile pas ß à SS : leurs longueurs diffèrent.

Exemples

public class Main {
    public static void main(String[] args) {
        System.out.println("Java".equalsIgnoreCase("jAvA"));
        System.out.println("Java".equals("jAvA"));
        System.out.println("Java".equalsIgnoreCase(null));
        System.out.println("ß".equalsIgnoreCase("SS"));
    }
}

Résultat

true
false
false
false

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