CKTIS / Java
String.equals — comparer le contenu des chaînes
String.equals compare le contenu des chaînes en tenant compte de la casse. L’opérateur == compare l’identité des objets, et non leur contenu.
Version : Java SE 21; repository runtime, production runtime not attested
Syntaxe
public boolean equals(Object anObject)String.equals a pour signature public boolean equals(Object anObject). La méthode renvoie true uniquement si l’argument est une référence non nulle vers un objet String contenant exactement la même séquence de caractères. La comparaison tient compte de la casse : "Java".equals("java") renvoie false.
Pour des références, == vérifie si elles désignent le même objet. Dans l’exemple, new String("Java") crée un objet distinct. Ainsi, a.equals(b) renvoie true, tandis que a == b renvoie false.
Un argument d’un autre type, comme StringBuilder, renvoie false, même si le contenu est identique. a.equals(null) renvoie false si a n’est pas null. Appeler une méthode sur une référence null déclenche une NullPointerException ; écrire "Java".equals(missing) évite ce problème.
Périmètre de la documentation : Java SE 21. L’environnement d’exécution du dépôt et celui de production n’ont pas été attestés.
Exemples
public class Main {
public static void main(String[] args) {
String a = "Java";
String b = new String("Java");
String missing = null;
System.out.println(a.equals(b));
System.out.println(a == b);
System.out.println(a.equals("java"));
System.out.println(a.equals(new StringBuilder("Java")));
System.out.println(a.equals(missing));
System.out.println("Java".equals(missing));
}
}Résultat
true false false false false false
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.