Collator::setStrength()

设置排序时使用的比较强度(collation strength)

首字母:C

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 扩展支持。

同首字母函数