CKTIS / Java
String.compareToIgnoreCase(String) — comparer des chaînes sans tenir compte de la casse
Comparez deux chaînes dans l’ordre lexicographique sans distinguer les majuscules des minuscules, puis déduisez leur ordre du signe de l’`int` renvoyé.
Version : Java SE 21
Syntaxe
public int compareToIgnoreCase(String str)
int result = left.compareToIgnoreCase(right);String.compareToIgnoreCase(String) est une méthode d’instance de String. L’appel left.compareToIgnoreCase(right) compare deux chaînes dans l’ordre lexicographique sans tenir compte de la casse. Il renvoie un int : < 0 signifie que left précède right, == 0 que les chaînes sont équivalentes pour cette comparaison, et > 0 que left suit right. Testez le signe plutôt que de supposer que le résultat vaut toujours -1, 0 ou 1.
Dans Java SE 21, le résultat a le même signe qu’un appel à compareTo après application de Character.toLowerCase(Character.toUpperCase(cp)) à chaque point de code Unicode cp des deux chaînes. Les chaînes d’origine ne sont pas modifiées. La méthode ne tient pas compte des règles locales. Pour trier du texte selon les règles d’une langue donnée, utilisez java.text.Collator avec la Locale appropriée.
Utilisez compareTo si la casse doit influer sur l’ordre lexicographique, et equalsIgnoreCase si vous voulez seulement un boolean indiquant l’égalité sans tenir compte de la casse. Si left ou right vaut null, left.compareToIgnoreCase(right) lève une NullPointerException. Si left n’est pas null, left.equalsIgnoreCase(null) renvoie false.
Exemples
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)));
}
}Résultat
0 -1 1
`apple` et `APPLE` donnent `0`. `apple` précède `Banana` ; inverser la comparaison change le signe. Les deux dernières lignes utilisent `Integer.signum` pour ramener les résultats à `-1` et `1`.
Leçons associées
- Java · Leçon 63 · Débutant · Version : 2