WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Collator — Text nach Sprachregeln vergleichen

java.text.Collator vergleicht Text nach den Regeln eines ausgewählten Locale. Damit lässt sich festlegen, welche Unterschiede berücksichtigt werden und wie zusammengesetzte Unicode-Zeichen behandelt werden.

Version: Java SE 21; repository runtime, production runtime not attested

Syntax

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

java.text.Collator ist eine abstrakte Klasse für den sprachabhängigen Vergleich von Zeichenketten. Verwenden Sie getInstance(locale), statt sich auf das standardmäßige Locale zu verlassen. Das Ergebnis von compare(left, right) ist negativ, null oder positiv; gehen Sie nicht davon aus, dass es genau -1 oder 1 ist. Null bedeutet Gleichwertigkeit nach den Regeln, nicht unbedingt eine identische Schreibweise.

Mit setStrength legen Sie fest, welche Ebenen unterschieden werden: PRIMARY unterscheidet üblicherweise Grundbuchstaben, SECONDARY zusätzlich Akzente und TERTIARY auch Groß- und Kleinschreibung. Welche Unterschiede dabei zählen, hängt vom Locale ab. IDENTICAL berücksichtigt verbleibende Unterschiede; das Ergebnis hängt jedoch weiterhin von der Dekomposition ab.

NO_DECOMPOSITION zerlegt Zeichen nicht; CANONICAL_DECOMPOSITION wendet die kanonische Dekomposition an, während FULL_DECOMPOSITION zusätzlich die Kompatibilitätsdekomposition anwendet. Bei RuleBasedCollator ist die kanonische Dekomposition für kombinierende Zeichen in nichtkanonischer Reihenfolge wichtig.

In der JDK-Implementierung kann ein gemeinsam genutzter RuleBasedCollator zu Konkurrenz zwischen Threads führen; ziehen Sie eine eigene Instanz pro Thread in Betracht. Geltungsbereich dieses Eintrags: Java SE 21; die Laufzeitumgebung des Repositorys und die Produktionslaufzeit sind nicht bestätigt.

Beispiele

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

Ergebnis

true
true
true

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen