عرض مصدر PHP/stristr

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

الدالة <code>stristr()‎</code> نسخة غير حساس لحالة الأحرف من الدالة <code>[[PHP/strstr|strstr()‎]]</code>.

== الوصف ==
<syntaxhighlight lang="php">
string stristr ( string $haystack , mixed $needle [, bool $before_needle = FALSE ] )
</syntaxhighlight>تبحث الدالة <code>stristr()‎</code> عن أول ظهور للسلسلة النصيَّة <code>needle</code> في السلسلة النصيَّة <code>haystack</code> ثم تعيد جزءًا من هذه السلسلة والتي تبدأ من بداية المعامل <code>needle</code> -الذي عثر عليه أولًا- وحتى نهاية السلسلة.

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

=== <code>haystack</code> ===
السلسلة النصيَّة التي ستبحث الدالة فيها.

=== <code>needle</code> ===
مجموعة المحارف (السلسلة النصيَّة) التي ستبحث الدالة عنها. إن لم تكن تلك المحارف سلسلةً نصيَّةً، فستُحوَّل إلى عدد صحيح وتُعامل على أنَّها قيمة ترتيبيَّة للمحارف.

=== <code>before_needle</code> ===
معامل اختياري. إن كانت قيمته <code>TRUE</code>، فستعيد الدالة <code>[[PHP/strstr|strstr()‎]]</code> جزءًا من السلسلة النصيَّة <code>haysatck</code> الواقع قبل أول ظهور للمعامل <code>needle</code> ولا يكون هذا المعامل ضمن القيمة المعادة.

يُفْحَصُ المعاملان <code>needle</code> و <code>haystack</code> بطريقة غير حساسة لحالة الأحرف.

== القيم المعادة ==
تعيد الدالة <code>stristr()‎</code> جزءًامن المعامل <code>haysatck</code> الواقع بين أول ظهور للمعامل <code>needle</code> في تلك السلسلة وحتى آخرها. إن لم يُعثر على المعامل <code>needle</code>، فستُعاد القيمة <code>FALSE</code>.

== سجل التغييرات ==
{| class="wikitable"
!الإصدار
!الوصف
|-
|5.3.0	
|أضيف المعامل الاختياري <code>before_needle</code>.
|-
|4.3.0	
|أصبحتْ الدالة <code>stristr()‎</code> آمنة ثنائية
|}

== أمثلة ==
المثال 1: مثال على الدالة <code>stristr()‎</code><syntaxhighlight lang="php">
<?php
$email = 'USER@EXAMPLE.com';
echo stristr($email, 'e'); // ER@EXAMPLE.com
echo stristr($email, 'e', true); // US بدءًا من الإصدار 5.3.0
?>
</syntaxhighlight>المثال 2: اختبار هل عُثِرَ على سلسلة نصية أم لا<syntaxhighlight lang="php">
<?php
$string = 'Hello World!';
if(stristr($string, 'earth') === FALSE) {
  echo '"earth" not found in string';
}
// "earth" not found in string
?>
</syntaxhighlight>المثال 3: استخدام المعامل <code>needle</code> وهو ليس "سلسلة نصية"<syntaxhighlight lang="php">
<?php
$string = 'APPLE';
echo stristr($string, 97); // 97 = lowercase a
// APPLE
?>
</syntaxhighlight>

== ملاحظات ==
هذه الدالة آمنة ثنائية.

== انظر أيضًا ==
* الدالة <code>[[PHP/strstr|strstr()‎]]</code>: البحث عن أوّل مطابقة لسلسلة نصية.
* الدالة <code>[[PHP/strrchr|strrchr()‎]]</code>: البحث عن آخر مطابقة للحرف في سلسلة نصية.
* الدالة <code>[[PHP/stripos|stripos()‎]]</code>: العثور على أول مطابقة لسلسلة نصية فرعية غير حساسة لحالة الأحرف في سلسلة نصية.
* الدالة <code>[[PHP/strpbrk|strpbrk()‎]]</code>: البحث عن سلسلة لأي مجموعة من الأحرف.
* الدالة <code>[[PHP/preg match|preg_match()‎]]</code>: إجراء مطابقة عبر التعابير النمطية.

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