CKTIS / Java
Collator — primerjanje besedila po jezikovnih pravilih
java.text.Collator primerja besedilo po pravilih izbranega Locale. Omogoča nastavitev pomembnih razlik in načina obravnave sestavljenih znakov Unicode.
Različica: Java SE 21; repository runtime, production runtime not attested
Sintaksa
Collator collator = Collator.getInstance(locale);
collator.setStrength(Collator.PRIMARY);
collator.setDecomposition(Collator.CANONICAL_DECOMPOSITION);
int result = collator.compare(left, right);java.text.Collator je abstrakten razred za jezikovno primerjanje nizov. Uporabite getInstance(locale) namesto zanašanja na privzeti Locale. Rezultat compare(left, right) je negativen, nič ali pozitiven; ne predpostavljajte, da je natanko -1 ali 1. Nič pomeni enakovrednost po pravilih, ne nujno enakega zapisa.
setStrength določa ravni razlikovanja: PRIMARY običajno razlikuje osnovne črke, SECONDARY dodatno razlikuje naglase, TERTIARY pa tudi velike in male črke. Dodelitev razlik je odvisna od locale. IDENTICAL razreši preostale razlike, vendar je rezultat še vedno odvisen od dekompozicije.
NO_DECOMPOSITION znakov ne razstavi; CANONICAL_DECOMPOSITION uporabi kanonično dekompozicijo, FULL_DECOMPOSITION pa tudi kompatibilno dekompozicijo. Pri RuleBasedCollator je kanonična dekompozicija pomembna za kombinirne znake v nekanoničnem vrstnem redu.
V implementaciji JDK lahko skupna raba RuleBasedCollator povzroči tekmovanje med nitmi; razmislite o ločeni instanci za vsako nit. Obseg tega zapisa: Java SE 21; izvajalno okolje repozitorija in produkcijsko izvajalno okolje nista potrjena.
Primeri
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);
}
}Rezultat
true true true
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.