الفرق بين المراجعتين لصفحة: «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"