Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

String.equals — porovnání obsahu řetězců

String.equals porovnává obsah řetězců a rozlišuje velká a malá písmena. Operátor == porovnává identitu objektů, nikoli jejich obsah.

Verze: Java SE 21; repository runtime, production runtime not attested

Syntaxe

public boolean equals(Object anObject)

String.equals má signaturu public boolean equals(Object anObject). Vrací true pouze tehdy, když je argument nenulový odkaz na objekt String se zcela stejnou posloupností znaků. Rozlišuje velká a malá písmena: "Java".equals("java") vrací false.

U odkazů operátor == ověřuje, zda odkazují na stejný objekt. V příkladu vytvoří new String("Java") samostatný objekt, takže a.equals(b) vrací true, zatímco a == b vrací false.

Argument jiného typu, například StringBuilder, vrátí false i při shodném obsahu. a.equals(null) vrací false, pokud a není null. Volání metody přes odkaz null vyvolá NullPointerException; zápis "Java".equals(missing) tomuto problému předejde.

Rozsah dokumentace: Java SE 21. Běhové prostředí repozitáře ani produkční běhové prostředí nebyly potvrzeny.

Příklady

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));
    }
}

Výsledek

true
false
false
false
false
false

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje