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() 獲取錯誤碼和錯誤資訊。