KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

Collator — tekst vergelijken volgens taalregels

java.text.Collator vergelijkt tekst volgens de regels van een gekozen Locale. Je kunt instellen welke verschillen meetellen en hoe samengestelde Unicode-tekens worden behandeld.

Versie: 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 is een abstracte klasse voor het taalkundig vergelijken van tekenreeksen. Gebruik getInstance(locale) in plaats van te vertrouwen op de standaard-Locale. Het resultaat van compare(left, right) is negatief, nul of positief; ga er niet van uit dat het precies -1 of 1 is. Nul betekent gelijkwaardigheid volgens de regels, niet noodzakelijk een identieke schrijfwijze.

setStrength bepaalt welke niveaus worden onderscheiden: PRIMARY onderscheidt doorgaans basisletters, SECONDARY ook accenten en TERTIARY daarnaast hoofdletters en kleine letters. Welke verschillen meetellen, hangt af van de locale. IDENTICAL beslist over de resterende verschillen, maar het resultaat blijft afhankelijk van de decompositie.

NO_DECOMPOSITION ontbindt tekens niet; CANONICAL_DECOMPOSITION past canonieke decompositie toe, terwijl FULL_DECOMPOSITION ook compatibiliteitsdecompositie toepast. Voor RuleBasedCollator is canonieke decompositie belangrijk bij combinerende tekens in een niet-canonieke volgorde.

In de JDK-implementatie kan een gedeelde RuleBasedCollator threadcontentie veroorzaken; overweeg een aparte instantie per thread. Reikwijdte van dit item: Java SE 21; de runtime van de repository en de productieruntime zijn niet bevestigd.

Voorbeelden

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

Resultaat

true
true
true

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen