عرض مصدر PHP/similar text

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

تحسب الدالة <code>similar_text()‎</code> عدد الأحرف المتشابهة في سلسلتين نصيتين.

== الوصف ==
<syntaxhighlight lang="php">
int similar_text ( string $first , string $second [, float &$percent ] )
</syntaxhighlight>تحسب الدالة <code>similar_text()‎</code> نسبة التشابه بين سلسلتين كما هو مذكور في كتاب Programming Classics: Implementing the World's Best Algorithms by Oliver‏ (<nowiki>ISBN 0-131-00413-1</nowiki>). لاحظ أن هذا التنفيذ لا يَستخدِم مكدسًا (stack) كما في الشفرة التي ذكرها المؤلف في كتابه، ولكن تجري استدعاءات تكرارية (recursive calls) مما قد يساهم أو قد لا يساهم في تسريع العملية بأكملها. لاحظ أيضًا أن تعقيد هذه الخوارزمية هو O(N**3)‎ حيث N هو طول أطول سلسلة نصية.

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

=== <code>first</code> ===
السلسلة النصية الأولى.

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

ملاحظة: قد يؤدي تبديل السلسلة الأولى بالثانية أو العكس إلى تغيرٍ في النتيجة (نسبة التشابه). انظر المثال أدناه.

=== <code>percent</code> ===
بتمرير [[PHP/references|مرجع]] (reference) كوسيط ثالث، فستحسب الدالة <code>similar_text()‎</code> التشابه في النسبة المئوية بقسمة النتيجة على متوسط أطوال السلسلتين المعطيَين مضروبًا (أي المتوسط) بالعدد 100.

== القيم المعادة ==
تعيد الدالة <code>similar_text()‎</code> عدد المحارف المتطابقة في السلسلتين المدخلتين.

يُحسب عدد المحارف المتطابقة بالعثور على أطول سلسلة فرعية مشتركة، ثم إعادة إجراء هذه العملية للسلسلة النصية التي تسبق السلسلة النصية الفرعية المشتركة والتي تليها تكراريًا (recursively). ثم ستُجمَع أطوال جميع الأجزاء الفرعية المشتركة.

== أمثلة ==
المثال 1: مثال على تبديل معاملات الدالة <code>similar_text()‎</code>

يُظهِرُ المثال الآتي تبديل المعامل <code>first</code> والمعامل <code>second</code> وتأثير ذلك على النتيجة:<syntaxhighlight lang="php">
<?php
$sim = similar_text('bafoobar', 'barfoo', $perc);
echo "similarity: $sim ($perc %)\n";

$sim = similar_text('barfoo', 'bafoobar', $perc);
echo "similarity: $sim ($perc %)\n";
</syntaxhighlight>تكون نتيجة المثال السابق كالآتي:<syntaxhighlight lang="text">
similarity: 5 (71.428571428571 %)
similarity: 3 (42.857142857143 %)
</syntaxhighlight>

== انظر أيضًا ==
* الدالة <code>[[PHP/levenshtein|levenshtein()‎]]</code>: حساب مسافة Levenshtein بين سلسلتين.
* الدالة <code>[[PHP/soundex|soundex()‎]]</code>: حساب مفتاح soundex لسلسلة.

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