الفرق بين المراجعتين ل"PHP/metaphone"

من موسوعة حسوب
< PHP
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:الدالة metaphone()‎ في PHP}}</noinclude>')
 
(إضافة عنوان الصفحة والتصنيفات)
 
(مراجعتان متوسطتان بواسطة مستخدمين اثنين آخرين غير معروضتين)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE:الدالة metaphone()‎ في PHP}}</noinclude>
+
<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]]

المراجعة الحالية بتاريخ 12:15، 8 أبريل 2018

(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"

مصادر