Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła