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

CKTIS / Java

Collator — porovnávání textu podle jazykových pravidel

java.text.Collator porovnává text podle pravidel zvoleného Locale. Umožňuje nastavit, které rozdíly jsou důležité a jak se zachází se složenými znaky Unicode.

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

Syntaxe

Collator collator = Collator.getInstance(locale);
collator.setStrength(Collator.PRIMARY);
collator.setDecomposition(Collator.CANONICAL_DECOMPOSITION);
int result = collator.compare(left, right);

java.text.Collator je abstraktní třída pro jazykové porovnávání řetězců. Použijte getInstance(locale) místo spoléhání na výchozí Locale. Výsledek compare(left, right) je záporný, nula nebo kladný; nepředpokládejte, že bude přesně -1 nebo 1. Nula znamená ekvivalenci podle pravidel, nikoli nutně totožný zápis.

setStrength nastavuje rozlišované úrovně: PRIMARY obvykle rozlišuje základní písmena, SECONDARY navíc rozlišuje diakritiku a TERTIARY také velikost písmen. To, jak jsou rozdíly přiřazeny, závisí na locale. IDENTICAL rozhoduje o zbývajících rozdílech, výsledek však stále závisí na dekompozici.

NO_DECOMPOSITION znaky nerozkládá; CANONICAL_DECOMPOSITION používá kanonickou dekompozici, zatímco FULL_DECOMPOSITION používá také kompatibilní dekompozici. U RuleBasedCollator je kanonická dekompozice důležitá pro kombinující znaky v nekanonickém pořadí.

Ve implementaci JDK může sdílený RuleBasedCollator způsobovat souběžné soupeření vláken; zvažte samostatnou instanci pro každé vlákno. Rozsah tohoto záznamu: Java SE 21; běhové prostředí repozitáře ani produkční běhové prostředí nejsou potvrzeny.

Příklady

import java.text.Collator;
import java.util.Locale;

public class Main {
    public static void main(String[] args) {
        Collator collator = Collator.getInstance(Locale.US);
        collator.setStrength(Collator.PRIMARY);
        collator.setDecomposition(Collator.CANONICAL_DECOMPOSITION);

        System.out.println(collator.compare("abc", "ABC") == 0);
        System.out.println(collator.compare("abc", "abd") < 0);
        System.out.println(collator.compare("\u00E9", "e\u0301") == 0);
    }
}

Výsledek

true
true
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