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

CKTIS / Java

String.equalsIgnoreCase — porovnání bez rozlišování velkých a malých písmen

String.equalsIgnoreCase porovnává řetězce bez rozlišování velkých a malých písmen, nezávisle na místním nastavení. Vrací hodnotu boolean.

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

Syntaxe

public boolean equalsIgnoreCase(String anotherString)

String.equalsIgnoreCase vyžaduje, aby řetězce měly stejnou délku a aby si odpovídající kódové body Unicode odpovídaly. Kódové body si odpovídají, pokud jsou totožné nebo pokud Character.toLowerCase(Character.toUpperCase(int)) vrátí stejný výsledek.

Argument null vrací false; zavolání metody na příjemci null vyvolá NullPointerException. Na rozdíl od této metody rozlišuje equals velká a malá písmena.

Metoda nezohledňuje místní nastavení; pro porovnávání závislé na jazyce použijte Collator. Nepovažuje ß za ekvivalentní SS: jejich délky se liší.

Příklady

public class Main {
    public static void main(String[] args) {
        System.out.println("Java".equalsIgnoreCase("jAvA"));
        System.out.println("Java".equals("jAvA"));
        System.out.println("Java".equalsIgnoreCase(null));
        System.out.println("ß".equalsIgnoreCase("SS"));
    }
}

Výsledek

true
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