الفرق بين المراجعتين لصفحة: «PHP/metaphone»

من موسوعة حسوب
< PHP
لا ملخص تعديل
إضافة عنوان الصفحة والتصنيفات
 
(1 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE:الدالة metaphone()‎ في PHP}}</noinclude>
<noinclude>{{DISPLAYTITLE:الدالة <code>metaphone()‎</code> في PHP}}</noinclude>
(PHP 4, PHP 5, PHP 7)
(PHP 4, PHP 5, PHP 7)


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


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


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


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


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


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


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


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


=== مصادر ===
== مصادر ==
* صفحة الدالة metaphone في توثيق PHP الرسمي.
* [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"

مصادر