Collator::setStrength()函数—用法及示例

PHP函数：Collator::setStrength()

适用版本：PHP 5 >= 5.3.0, PHP 7, PHP 8

用法：Collator::setStrength() 方法用于设置排序时使用的比较强度（collation strength）。比较强度决定了字符串排序时所考虑的字符属性的数量。

参数：

1. strength (int)：比较强度，取值范围为 0 到 3，具体含义如下：
   • Collator::PRIMARY (0)：只考虑基本字符，不考虑重音符号、大小写等差异。
   • Collator::SECONDARY (1)：考虑基本字符和重音符号的差异，但不考虑大小写差异。
   • Collator::TERTIARY (2)：考虑基本字符、重音符号和大小写的差异。
   • Collator::QUATERNARY (3)：考虑基本字符、重音符号、大小写和符号的差异。
   • Collator::IDENTICAL (15)：考虑基本字符、重音符号、大小写、符号和字符标准化形式的差异。

返回值：成功时返回 true，失败时返回 false。

示例：

$coll = new Collator('en_US');
$coll->setStrength(Collator::TERTIARY);

$fruits = ['apple', 'banana', 'Orange', 'Pineapple'];

$coll->sort($fruits);

print_r($fruits);

输出：

Array
(
    [0] => apple
    [1] => banana
    [2] => Orange
    [3] => Pineapple
)

在上面的示例中，创建了一个 Collator 对象，并设置了比较强度为 Collator::TERTIARY。然后对 $fruits 数组进行排序，最终输出排序后的结果。

注意：Collator 类需要 intl 扩展支持。