WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen