الدالة metaphone()‎ في 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"

مصادر

• صفحة الدالة metaphone في توثيق PHP الرسمي.