Collator::getSortKey

collator_get_sort_key

(PHP 5 >= 5.3.2, PHP 7, PHP 8, PECL intl >= 1.0.3)

Collator::getSortKey -- collator_get_sort_key — 取得字串的排序鍵值

物件導向風格

public Collator::getSortKey(字串 $string): 字串|false

程序式風格

collator_get_sort_key(Collator $object, 字串 $string): 字串|false

傳回字串的排序鍵。排序鍵可以直接比較，而不必比較字串，但排序鍵是依實作而定，並且可能在不同 ICU 程式庫版本之間有所變更。排序鍵通常僅適用於資料庫或其他函式呼叫成本極高的情況。

傳回字串的排序鍵，失敗時則傳回 false。

警告

此函式可能傳回布林值 false，但也可能傳回評估為 false 的非布林值。請閱讀布林值的章節以了解更多資訊。使用 === 運算子來測試此函式的傳回值。

範例 #1 collator_get_sort_key() 範例

<?php
$s1 = 'Hello';

$coll = collator_create('en_US');
$res = collator_get_sort_key($coll, $s1);

echo bin2hex($res);
?>

上述範例將輸出類似以下的內容

3832404046010901dc08

此頁面沒有使用者貢獻的註解。