Intl.Collator.prototype.compare()

¥Syntax

compare(string1, string2)

¥Parameters

string1、string2

要相互比较的字符串。

¥Return value

一个数字，指示 string1 和 string2 如何根据 Intl.Collator 对象的排序顺序相互比较：

¥A number indicating how string1 and string2 compare to each other according to the sort order of this Intl.Collator object:

• 如果 string1 在 string2 之前，则为负值；
• 如果 string1 在 string2 之后，则为正值；
• 如果认为它们相等，则为 0。

¥Examples

¥Using compare for array sort

使用 compare 函数对数组进行排序。请注意，该函数绑定到从中获取它的整理器，因此它可以直接传递给 Array.prototype.sort()。

¥Use the compare function for sorting arrays. Note that the function is bound to the collator from which it was obtained, so it can be passed directly to Array.prototype.sort().

const a = ["Offenbach", "Österreich", "Odenwald"];
const collator = new Intl.Collator("de-u-co-phonebk");
a.sort(collator.compare);
console.log(a.join(", ")); // "Odenwald, Österreich, Offenbach"

¥Using compare for array search

使用 compare 函数在数组中查找匹配字符串：

¥Use the compare function for finding matching strings in arrays:

const a = ["Congrès", "congres", "Assemblée", "poisson"];
const collator = new Intl.Collator("fr", {
  usage: "search",
  sensitivity: "base",
});
const s = "congres";
const matches = a.filter((v) => collator.compare(v, s) === 0);
console.log(matches.join(", ")); // "Congrès, congres"

¥See also

• Intl.Collator
• String.prototype.localeCompare()