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

CKTIS / Java

String.compareTo — lexikografické porovnání

String.compareTo porovnává řetězce lexikograficky. O pořadí rozhoduje znaménko výsledku; nula znamená stejný obsah.

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

Syntaxe

public int compareTo(String anotherString)
// Usage: int result = left.compareTo(right);

String.compareTo vrací int: záporný výsledek znamená, že levý řetězec předchází pravému; kladný znamená, že následuje po něm. Nula odpovídá rovnosti podle equals.

Při porovnání se rozlišují malá a velká písmena a používají se hodnoty UTF-16 kódových jednotek (char), nikoli jazyková pravidla. Výsledek je rozdíl prvních odlišných jednotek; pokud je jeden řetězec prefixem druhého, jde o rozdíl délek. Nepředpokládejte, že výsledek může být pouze -1, 0 nebo 1: kontrolujte znaménko.

Argument null způsobí NullPointerException. Pro porovnávání závislé na jazyce použijte Collator.

Příklady

public class Main {
    public static void main(String[] args) {
        System.out.println("cat".compareTo("car"));
        System.out.println("car".compareTo("cart"));
        System.out.println("cat".compareTo("cat"));
        System.out.println("A".compareTo("a") < 0);
    }
}

Výsledek

2
-1
0
true

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