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.