函式名: metaphone()
適用版本: PHP 4, PHP 5, PHP 7
函式描述: metaphone() 函式計算給定字串的 metaphone 鍵
用法:
metaphone ( string $str [, int $phonemes = 0 ] ) : string|false
引數:
- $str: 必需,要計算 metaphone 鍵的字串。
- $phonemes: 可選,指定返回的 metaphone 鍵的最大長度。預設為 0,表示不限制長度。
返回值:
- 返回計算得到的 metaphone 鍵的字串。若發生錯誤,則返回 false。
示例:
$str1 = "hello";
$str2 = "world";
$metaphone1 = metaphone($str1);
echo $metaphone1; // 輸出:"HL"
$metaphone2 = metaphone($str2);
echo $metaphone2; // 輸出:"WRLT"
$metaphone3 = metaphone($str1, 4);
echo $metaphone3; // 輸出:"HL"
注意事項:
- metaphone() 函式返回的 metaphone 鍵是一個用於發音比較的字串,它忽略了字串中的一些常見拼寫規則和發音變化。
- metaphone() 函式對於不同的字串可能返回相同的 metaphone 鍵,因此它不適用於精確的字串匹配,而主要用於發音相似性的比較。
- $phonemes 引數可用於控制返回的 metaphone 鍵的長度,較大的值將返回較長的鍵,但可能會增加錯誤匹配的可能性。預設情況下,不限制返回鍵的長度。
- metaphone() 函式在計算 metaphone 鍵時,會忽略字串中的非字母字元。
- metaphone() 函式在計算 metaphone 鍵時,對於某些特定的字串會返回 false。因此,在使用返回值之前,應該檢查函式是否返回了 false。