CKTIS / Java
String.equals — Zeichenfolgeninhalte vergleichen
String.equals vergleicht Zeichenfolgeninhalte unter Beachtung der Groß- und Kleinschreibung. Der Operator == vergleicht die Objektidentität, nicht den Inhalt.
Version: Java SE 21; repository runtime, production runtime not attested
Syntax
public boolean equals(Object anObject)String.equals hat die Signatur public boolean equals(Object anObject). Die Methode gibt nur dann true zurück, wenn das Argument eine nicht-null-Referenz auf ein String-Objekt mit derselben Zeichenfolge ist. Bei der Prüfung wird zwischen Groß- und Kleinschreibung unterschieden: "Java".equals("java") gibt false zurück.
Bei Referenzen prüft ==, ob sie auf dasselbe Objekt verweisen. Im Beispiel erzeugt new String("Java") ein separates Objekt. Daher gibt a.equals(b) den Wert true zurück, während a == b den Wert false zurückgibt.
Ein Argument eines anderen Typs, etwa StringBuilder, ergibt auch bei übereinstimmendem Inhalt false. a.equals(null) gibt false zurück, sofern a nicht null ist. Ein Methodenaufruf über eine null-Referenz löst eine NullPointerException aus; mit "Java".equals(missing) lässt sich dieses Problem vermeiden.
Dokumentationsumfang: Java SE 21. Die Laufzeitumgebung des Repositorys und die Produktionslaufzeitumgebung wurden nicht bestätigt.
Beispiele
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));
}
}Ergebnis
true false false false false false
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.