WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

String.equalsIgnoreCase — Vergleich ohne Beachtung der Groß- und Kleinschreibung

String.equalsIgnoreCase vergleicht Zeichenfolgen, ohne zwischen Groß- und Kleinschreibung zu unterscheiden, unabhängig von den Gebietsschemaeinstellungen. Die Methode gibt einen boolean zurück.

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

Syntax

public boolean equalsIgnoreCase(String anotherString)

String.equalsIgnoreCase setzt voraus, dass die Zeichenfolgen gleich lang sind und die entsprechenden Unicode-Codepoints übereinstimmen. Codepoints stimmen überein, wenn sie identisch sind oder Character.toLowerCase(Character.toUpperCase(int)) dasselbe Ergebnis liefert.

Ein null-Argument ergibt false; wird die Methode auf einem null-Empfänger aufgerufen, wird eine NullPointerException ausgelöst. Im Gegensatz zu dieser Methode unterscheidet equals zwischen Groß- und Kleinschreibung.

Die Methode berücksichtigt keine Gebietsschemaeinstellungen; für sprachabhängige Vergleiche verwenden Sie Collator. Sie setzt ß nicht mit SS gleich: Die Längen unterscheiden sich.

Beispiele

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"));
    }
}

Ergebnis

true
false
false
false

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen