الدالة metaphone() في PHP
< PHP
(PHP 4, PHP 5, PHP 7)
تحسب الدالة metaphone() مفتاح metaphone لسلسلة نصية.
الوصف
string metaphone ( string $str [, int $phonemes = 0 ] )
تحسب الدالة metaphone() مفتاح metaphone للمعامل str.
تُماثل الدالةُ metaphone() الدالةَ soundex() في إعطاء نفس المفاتيح للكلمات التي تتشابه في النطق. لكنها أدَقُ من الدالة soundex() لأنها تأخذ بالحسبان قواعد نطق اللغة الإنجليزية. تُعيد الدالة metaphone() مفاتيح بأطوال متغيرة (أي ليس لها طولٌ ثابت).
المعاملات
str
السلسلة النصية.
phonemes
يُحدد هذا المعامل طول المفتاح المُعاد بعدد phonemes من المحَارف، القيمة الافتراضية للمعامل هي 0 أي لا يوجد أي حد.
القيم المعادة
تُعيد الدالة metaphone() قيمة المفتاح metaphone للسلسلة النصية، أو القيمة FALSE في حال فشلها.
أمثلة
المثال 1: مثال بسيط عن الدالة metaphone()
<?php
var_dump(metaphone('programming'));
var_dump(metaphone('programmer'));
?>
يُعيد المثال السابق ما يلي:
string(7) "PRKRMNK"
string(6) "PRKRMR"
المثال 2: استخدام المعامل phonemes
<?php
var_dump(metaphone('programming', 5));
var_dump(metaphone('programmer', 5));
?>
سيُخرِج المثال السابق الناتج الآتي:
string(5) "PRKRM"
string(5) "PRKRM"