CKTIS / Java
Collator — usporedba teksta prema jezičnim pravilima
java.text.Collator uspoređuje tekst prema pravilima odabranog Locale. Omogućuje postavljanje važnih razlika i načina obrade složenih Unicode znakova.
Verzija: Java SE 21; repository runtime, production runtime not attested
Sintaksa
Collator collator = Collator.getInstance(locale);
collator.setStrength(Collator.PRIMARY);
collator.setDecomposition(Collator.CANONICAL_DECOMPOSITION);
int result = collator.compare(left, right);java.text.Collator je apstraktna klasa za jezičnu usporedbu nizova znakova. Upotrijebite getInstance(locale) umjesto oslanjanja na zadani Locale. Rezultat metode compare(left, right) negativan je, nula ili pozitivan; nemojte pretpostaviti da je točno -1 ili 1. Nula znači ekvivalentnost prema pravilima, a ne nužno jednak zapis.
setStrength određuje razine koje se razlikuju: PRIMARY obično razlikuje osnovna slova, SECONDARY dodatno razlikuje naglaske, a TERTIARY i velika i mala slova. Dodjela razlika ovisi o localeu. IDENTICAL razrješava preostale razlike, no rezultat i dalje ovisi o dekompoziciji.
NO_DECOMPOSITION ne rastavlja znakove; CANONICAL_DECOMPOSITION primjenjuje kanoničku dekompoziciju, dok FULL_DECOMPOSITION primjenjuje i kompatibilnu dekompoziciju. Za RuleBasedCollator kanonička je dekompozicija važna kod kombinirajućih znakova u nekanoničkom redoslijedu.
U implementaciji JDK-a dijeljeni RuleBasedCollator može uzrokovati nadmetanje među dretvama; razmotrite zasebnu instancu za svaku dretvu. Opseg ovog unosa: Java SE 21; okruženje izvođenja repozitorija i produkcijsko okruženje nisu potvrđeni.
Primjeri
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);
}
}Rezultat
true true true
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.