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.