[函数]Collator::compare()函数—用法及示例

函数名：Collator::compare()

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

函数描述：Collator::compare() 用于比较两个字符串的排序顺序。

用法：

Collator::compare ( string $str1 , string $str2 ) : int|Collator

参数：

• $str1: 第一个要比较的字符串。

• $str2: 第二个要比较的字符串。

返回值：

• 如果 $str1 大于 $str2，返回正数。

• 如果 $str1 小于 $str2，返回负数。

• 如果 $str1 等于 $str2，返回 0。

示例：

$collator = new Collator('en_US');
echo $collator->compare('apple', 'banana'); // 输出负数
echo $collator->compare('banana', 'apple'); // 输出正数
echo $collator->compare('apple', 'apple');  // 输出 0

注意：

• 在使用这个函数之前，需要先实例化 Collator 类。

• $str1 和 $str2 的比较受到当前 Collator 对象的排序规则影响，该排序规则可以通过 Collator 构造函数的可选参数进行设置。

• 如果比较出现错误，函数将返回 Collator 对象本身，可以通过 Collator::getErrorCode() 和 Collator::getErrorMessage() 获取错误码和错误信息。