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

CKTIS / Java

String.compareToIgnoreCase(String) — porovnávání řetězců bez rozlišení velikosti písmen

Porovnej dva řetězce lexikograficky bez rozlišení velkých a malých písmen a urči jejich pořadí podle znaménka výsledku typu `int`.

Verze: Java SE 21

Syntaxe

public int compareToIgnoreCase(String str)

int result = left.compareToIgnoreCase(right);

String.compareToIgnoreCase(String) je instanční metoda třídy String. Volání left.compareToIgnoreCase(right) porovná dva řetězce lexikograficky bez rozlišení velkých a malých písmen. Vrací int: < 0 znamená, že left je před right, == 0 znamená, že jsou si při tomto porovnání rovny, a > 0 znamená, že left je za right. Kontroluj znaménko a nepředpokládej, že výsledek je vždy -1, 0 nebo 1.

V Java SE 21 má výsledek stejné znaménko jako výsledek compareTo po použití Character.toLowerCase(Character.toUpperCase(cp)) na každý kódový bod Unicode cp v obou řetězcích. Původní řetězce se nemění. Metoda nezohledňuje jazyková ani regionální pravidla. K řazení textu podle pravidel konkrétního jazyka použij java.text.Collator s odpovídajícím Locale.

Použij compareTo, pokud má velikost písmen ovlivnit lexikografické pořadí, a equalsIgnoreCase, pokud potřebuješ jen hodnotu typu boolean, která říká, zda jsou řetězce shodné bez rozlišení velikosti písmen. Pokud je left nebo right rovno null, volání left.compareToIgnoreCase(right) vyvolá výjimku NullPointerException. Pokud left není null, volání left.equalsIgnoreCase(null) vrátí false.

Příklady

public class Main {
    public static void main(String[] args) {
        String first = "apple";
        String second = "Banana";

        System.out.println(first.compareToIgnoreCase("APPLE"));
        System.out.println(Integer.signum(first.compareToIgnoreCase(second)));
        System.out.println(Integer.signum(second.compareToIgnoreCase(first)));
    }
}

Výsledek

0
-1
1

Porovnání `apple` a `APPLE` dává `0`. `apple` je před `Banana`; obrácením porovnání se znaménko změní. Poslední dva řádky používají `Integer.signum` k převodu výsledků na `-1` a `1`.

Související lekce

  • Java · Lekce 63 · Základní · Verze: 2

Zdroje