CKTIS / JavaScript
Intl.Collator: osjetljivost usporedbe i jezična pravila sortiranja
Uspoređujte i sortirajte nizove znakova prema pravilima odabrane jezične postavke. Opcija `sensitivity` određuje koje razlike utječu na usporedbu.
Verzija: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
new Intl.Collator(locales, { sensitivity: "base" | "accent" | "case" | "variant", usage: "sort" | "search" })
collator.compare(a, b)
strings.sort(collator.compare)
Intl.Collator.supportedLocalesOf(locales)
collator.resolvedOptions()
The `|` notation lists alternatives; pass one string value per option. Both constructor arguments and both shown options are optional.U Intl.Collator pravila sortiranja stvarno korištene jezične postavke (locale) određuju što je osnovno slovo. U zadanom njemačkom sortiranju ä je varijanta slova a, dok je u švedskom zasebno slovo. Zato uz "base" ta dva niza znakova mogu biti jednakovrijedna u de, ali ne i u sv.
Različita osnovna slova razlikuju se pri svakoj vrijednosti opcije sensitivity. Za varijante istoga osnovnog slova "base" zanemaruje dijakritičke znakove i razliku između velikih i malih slova; "accent" razlikuje dijakritičke znakove, ali ne velika i mala slova; "case" radi obrnuto; "variant" uzima u obzir obje vrste razlika, a može uzeti u obzir i druge. Vrijednost izvan tog popisa, kao što je "ignore", izaziva iznimku RangeError.
U zadanom načinu rada usage: "sort" zadana je osjetljivost "variant". Uz usage: "search" ovisi o jezičnoj postavci; u tom načinu koristite compare(a, b) === 0 za provjeru podudaranja, a ne za sortiranje. Pri sortiranju negativan rezultat znači da a dolazi prije b, pozitivan da dolazi poslije, a nula da ih usporedba smatra jednakovrijednima. Ne očekujte točno -1 ili 1. Funkcija collator.compare vezana je uz instancu pa je možete izravno proslijediti metodi sort(). Rezultat 0 ne znači da vrijedi a === b.
Izričito zatražite jezičnu postavku: ako se nijedna od traženih ne može upariti s dostupnom postavkom, okruženje koristi svoju zadanu postavku. Intl.Collator.supportedLocalesOf() provjerava podršku bez prelaska na zadanu postavku okruženja, a resolvedOptions().locale pokazuje koja se postavka stvarno koristi. Podaci za sortiranje mogu se razlikovati među okruženjima i verzijama čak i kad su stvarno korištene opcije iste.
Primjeri
{
const locales = ["en", "de", "sv"];
if (typeof Intl === "undefined" || typeof Intl.Collator !== "function" ||
Intl.Collator.supportedLocalesOf(locales).length !== locales.length) {
console.log("Intl.Collator or required locales unavailable");
} else {
for (const sensitivity of ["base", "accent", "case", "variant"]) {
const { compare } = new Intl.Collator("en", { sensitivity });
console.log(`${sensitivity}: ${compare("a", "á") === 0}, ${compare("a", "A") === 0}`);
}
for (const locale of ["de", "sv"]) {
const { compare } = new Intl.Collator(locale, { sensitivity: "base" });
console.log(`${locale}: ${compare("a", "ä") === 0}`);
}
}
}Rezultat
base: true, true accent: false, true case: true, false variant: false, false de: true sv: false
U prva četiri retka `true` znači da usporedba par smatra jednakovrijednim: najprije `a` i `á`, zatim `a` i `A`. Posljednja dva retka uspoređuju `a` s `ä` uz `"base"` u `de` i `sv`. Prikazani ispis pretpostavlja podršku za te postavke i `en` te primjenu opisanih zadanih pravila sortiranja.
Povezane lekcije
- JavaScript · Lekcija 24 · Srednje · Verzija: 3