WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

String.compareToIgnoreCase(String) — Zeichenketten ohne Beachtung der Groß- und Kleinschreibung vergleichen

Vergleiche zwei Zeichenketten lexikografisch, ohne Groß- und Kleinschreibung zu beachten, und lies ihre Reihenfolge am Vorzeichen des `int`-Ergebnisses ab.

Version: Java SE 21

Syntax

public int compareToIgnoreCase(String str)

int result = left.compareToIgnoreCase(right);

String.compareToIgnoreCase(String) ist eine Instanzmethode von String. Der Aufruf left.compareToIgnoreCase(right) vergleicht zwei Zeichenketten lexikografisch, ohne Groß- und Kleinschreibung zu beachten. Das Ergebnis ist ein int: < 0 bedeutet, dass left vor right steht, == 0, dass beide im Vergleich gleich sind, und > 0, dass left nach right steht. Prüfe das Vorzeichen, statt davon auszugehen, dass das Ergebnis immer -1, 0 oder 1 ist.

In Java SE 21 hat das Ergebnis dasselbe Vorzeichen wie ein Vergleich mit compareTo, nachdem auf jeden Unicode-Codepunkt cp beider Zeichenketten Character.toLowerCase(Character.toUpperCase(cp)) angewendet wurde. Die ursprünglichen Zeichenketten bleiben unverändert. Die Methode berücksichtigt keine sprach- oder regionsspezifischen Regeln. Verwende zum Sortieren nach den Regeln einer bestimmten Sprache java.text.Collator mit der passenden Locale.

Verwende compareTo, wenn Groß- und Kleinschreibung die lexikografische Reihenfolge beeinflussen soll, und equalsIgnoreCase, wenn du nur einen boolean-Wert für die Gleichheit ohne Beachtung der Groß- und Kleinschreibung brauchst. Ist left oder right gleich null, löst left.compareToIgnoreCase(right) eine NullPointerException aus. Ist left nicht null, gibt left.equalsIgnoreCase(null) den Wert false zurück.

Beispiele

public class Main {
    public static void main(String[] args) {
        String first = "apple";
        String second = "Banana";

        System.out.println(first.compareToIgnoreCase("APPLE"));
        System.out.println(Integer.signum(first.compareToIgnoreCase(second)));
        System.out.println(Integer.signum(second.compareToIgnoreCase(first)));
    }
}

Ergebnis

0
-1
1

`apple` und `APPLE` ergeben `0`. `apple` steht vor `Banana`; beim Umkehren des Vergleichs wechselt das Vorzeichen. Die letzten beiden Zeilen verwenden `Integer.signum`, um die Ergebnisse auf `-1` und `1` abzubilden.

Zugehörige Lektionen

  • Java · Lektion 63 · Grundlagen · Version: 2

Quellen