عرض مصدر PHP/metaphone

<noinclude>{{DISPLAYTITLE:الدالة <code>metaphone()‎</code> في PHP}}</noinclude>
(PHP 4, PHP 5, PHP 7)

تحسب الدالة <code>metaphone()‎</code> مفتاح metaphone لسلسلة نصية.

== الوصف ==
<syntaxhighlight lang="php">
string metaphone ( string $str [, int $phonemes = 0 ] )
</syntaxhighlight>تحسب الدالة <code>metaphone()‎</code> مفتاح metaphone للمعامل <code>str</code>.

تُماثل الدالةُ <code>metaphone()‎</code> الدالةَ <code>[[PHP/sound|soundex()‎]]</code> في إعطاء نفس المفاتيح للكلمات التي تتشابه في النطق. لكنها أدَقُ من الدالة <code>[[PHP/soundex|soundex()‎]]</code> لأنها تأخذ بالحسبان قواعد نطق اللغة الإنجليزية. تُعيد الدالة <code>metaphone()‎</code> مفاتيح بأطوال متغيرة (أي ليس لها طولٌ ثابت).

== المعاملات ==

=== <code>str</code> ===
السلسلة النصية.

=== <code>phonemes</code> ===
يُحدد هذا المعامل طول المفتاح المُعاد بعدد <code>phonemes</code> من المحَارف، القيمة الافتراضية للمعامل هي <code>0</code> أي لا يوجد أي حد.

== القيم المعادة ==
تُعيد الدالة <code>metaphone()‎</code> قيمة المفتاح metaphone للسلسلة النصية، أو القيمة <code>FALSE</code> في حال فشلها.

== أمثلة ==
المثال 1: مثال بسيط عن الدالة <code>metaphone()‎</code><syntaxhighlight lang="php">
<?php
var_dump(metaphone('programming'));
var_dump(metaphone('programmer'));
?>
</syntaxhighlight>يُعيد المثال السابق ما يلي:<syntaxhighlight lang="text">
string(7) "PRKRMNK"
string(6) "PRKRMR"
</syntaxhighlight>المثال 2: استخدام المعامل <code>phonemes</code><syntaxhighlight lang="php">
<?php
var_dump(metaphone('programming', 5));
var_dump(metaphone('programmer', 5));
?>
</syntaxhighlight>سيُخرِج المثال السابق الناتج الآتي:<syntaxhighlight lang="text">
string(5) "PRKRM"
string(5) "PRKRM"
</syntaxhighlight>

== مصادر ==
* [http://php.net/manual/en/function.metaphone.php صفحة الدالة metaphone في توثيق PHP الرسمي].
[[تصنيف:PHP]]
[[تصنيف:PHP Function]]
[[تصنيف:PHP String]]