CKTIS / Java
Collator — porównywanie tekstu według reguł językowych
java.text.Collator porównuje tekst zgodnie z regułami wybranego Locale. Pozwala określić istotność różnic oraz sposób obsługi złożonych znaków Unicode.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
Collator collator = Collator.getInstance(locale);
collator.setStrength(Collator.PRIMARY);
collator.setDecomposition(Collator.CANONICAL_DECOMPOSITION);
int result = collator.compare(left, right);java.text.Collator to abstrakcyjna klasa do językowego porównywania napisów. Użyj getInstance(locale) zamiast polegać na domyślnym Locale. Wynik compare(left, right) jest ujemny, zerowy albo dodatni; nie zakładaj wartości dokładnie -1 lub 1. Zero oznacza równoważność według reguł, niekoniecznie identyczny zapis.
setStrength ustala rozróżniane poziomy: PRIMARY zwykle odróżnia litery podstawowe, SECONDARY dodatkowo akcenty, a TERTIARY także wielkość liter. Przypisanie różnic zależy od ustawień regionalnych. IDENTICAL rozstrzyga pozostałe różnice, lecz wynik nadal zależy od dekompozycji.
NO_DECOMPOSITION nie rozkłada znaków; CANONICAL_DECOMPOSITION uwzględnia rozkład kanoniczny, a FULL_DECOMPOSITION również zgodnościowy. Dla RuleBasedCollator rozkład kanoniczny jest ważny przy znakach łączących w niekanonicznej kolejności.
W implementacji JDK współdzielony RuleBasedCollator może powodować rywalizację wątków; rozważ osobną instancję na wątek. Zakres wpisu: Java SE 21; środowisko repozytorium i środowisko produkcyjne nie są potwierdzone.
Przykłady
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);
}
}Wynik
true true true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.