الدالة 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 الرسمي.