CKTIS / Java
String.compareToIgnoreCase(String) — confrontare stringhe senza distinguere maiuscole e minuscole
Confronta due stringhe in ordine lessicografico senza distinguere maiuscole e minuscole e ricava il loro ordine dal segno del valore `int` restituito.
Versione: Java SE 21
Sintassi
public int compareToIgnoreCase(String str)
int result = left.compareToIgnoreCase(right);String.compareToIgnoreCase(String) è un metodo di istanza di String. La chiamata left.compareToIgnoreCase(right) confronta due stringhe in ordine lessicografico senza distinguere maiuscole e minuscole. Restituisce un int: < 0 significa che left precede right, == 0 che le stringhe risultano equivalenti nel confronto e > 0 che left segue right. Controlla il segno, senza supporre che il risultato sia sempre -1, 0 o 1.
In Java SE 21 il risultato ha lo stesso segno di quello di compareTo dopo aver applicato Character.toLowerCase(Character.toUpperCase(cp)) a ogni punto di codice Unicode cp delle due stringhe. Le stringhe originali non vengono modificate. Il metodo non tiene conto delle regole locali. Per ordinare un testo secondo le regole di una lingua specifica, usa java.text.Collator con la Locale appropriata.
Usa compareTo se le maiuscole e le minuscole devono influire sull’ordine lessicografico e equalsIgnoreCase se ti serve soltanto un boolean che indichi l’uguaglianza senza distinguere maiuscole e minuscole. Se left o right è null, left.compareToIgnoreCase(right) genera una NullPointerException. Se left non è null, left.equalsIgnoreCase(null) restituisce false.
Esempi
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)));
}
}Risultato
0 -1 1
`apple` e `APPLE` danno `0`. `apple` precede `Banana`; invertendo il confronto cambia il segno. Le ultime due righe usano `Integer.signum` per ricondurre i risultati a `-1` e `1`.
Lezioni correlate
- Java · Lezione 63 · Base · Versione: 2