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