函式名稱:Normalizer::normalize()
適用版本:PHP 5 >= 5.3.0, PHP 7
函式描述:該函式用於將Unicode字串規範化為指定的Unicode標準化形式。
用法:
string Normalizer::normalize ( string $input [, int $form = Normalizer::FORM_C ] )
引數:
- $input:需要進行規範化的Unicode字串。
- $form:可選引數,指定要使用的Unicode標準化形式。預設為Normalizer::FORM_C,表示使用Unicode規範化形式C。
返回值:
返回規範化後的字串,如果規範化失敗則返回FALSE。
示例:
// 示例1:使用預設的規範化形式C
$input = "é";
$result = Normalizer::normalize($input);
echo $result; // 輸出:é
// 示例2:使用規範化形式KD
$input = "é";
$result = Normalizer::normalize($input, Normalizer::FORM_KD);
echo $result; // 輸出:é
// 示例3:規範化失敗
$input = "?";
$result = Normalizer::normalize($input);
var_dump($result); // 輸出:bool(false)
在示例1中,輸入的字串是一個帶有重音符號的字母"é"。使用預設的規範化形式C,函式將保持字串不變。
在示例2中,同樣是輸入帶有重音符號的字母"é",但是這次指定了規範化形式KD。函式將將重音符號分解為兩個字元,輸出的結果是"é"。
在示例3中,輸入的字串是一個表情符號"?",這個字元無法被規範化,因此函式返回FALSE。