База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

Collator — сравняване на текст според езиковите правила

java.text.Collator сравнява текст според правилата на избран Locale. Позволява да зададете кои разлики имат значение и как се обработват съставните Unicode знаци.

Версия: Java SE 21; repository runtime, production runtime not attested

Синтаксис

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

java.text.Collator е абстрактен клас за езиково сравняване на низове. Използвайте getInstance(locale), вместо да разчитате на подразбиращия се Locale. Резултатът от compare(left, right) е отрицателен, нула или положителен; не приемайте, че е точно -1 или 1. Нула означава еквивалентност според правилата, а не непременно идентичен запис.

setStrength задава нивата, които се различават: PRIMARY обикновено различава основните букви, SECONDARY различава и ударенията, а TERTIARY — също главните и малките букви. Начинът на отчитане на разликите зависи от locale. IDENTICAL разрешава оставащите разлики, но резултатът продължава да зависи от декомпозицията.

NO_DECOMPOSITION не декомпозира знаците; CANONICAL_DECOMPOSITION прилага канонична декомпозиция, а FULL_DECOMPOSITION прилага и декомпозиция за съвместимост. При RuleBasedCollator каноничната декомпозиция е важна за комбиниращи знаци в неканоничен ред.

В реализацията на JDK споделен RuleBasedCollator може да предизвика конкуренция между нишки; обмислете отделен екземпляр за всяка нишка. Обхват на тази статия: Java SE 21; средата за изпълнение на хранилището и производствената среда не са потвърдени.

Примери

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);
    }
}

Резултат

true
true
true

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници