Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

Collator — confrontare il testo secondo le regole linguistiche

java.text.Collator confronta il testo secondo le regole di un Locale scelto. Consente di configurare quali differenze contano e come vengono gestiti i caratteri Unicode composti.

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

Sintassi

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

java.text.Collator è una classe astratta per il confronto linguistico delle stringhe. Usa getInstance(locale) invece di affidarti al Locale predefinito. Il risultato di compare(left, right) è negativo, zero o positivo; non presumere che sia esattamente -1 o 1. Zero indica equivalenza secondo le regole, non necessariamente una grafia identica.

setStrength seleziona i livelli distinti: PRIMARY in genere distingue le lettere di base, SECONDARY distingue anche gli accenti e TERTIARY anche le maiuscole e le minuscole. L’attribuzione delle differenze dipende dal locale. IDENTICAL risolve le differenze rimanenti, ma il risultato continua a dipendere dalla decomposizione.

NO_DECOMPOSITION non scompone i caratteri; CANONICAL_DECOMPOSITION applica la decomposizione canonica, mentre FULL_DECOMPOSITION applica anche quella di compatibilità. Per RuleBasedCollator, la decomposizione canonica è importante con i caratteri combinanti in ordine non canonico.

Nell’implementazione del JDK, un RuleBasedCollator condiviso può causare contesa tra thread; valuta l’uso di un’istanza separata per ogni thread. Ambito della voce: Java SE 21; l’ambiente di esecuzione del repository e quello di produzione non sono attestati.

Esempi

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

Risultato

true
true
true

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti