PHP/stristr

(PHP 4, PHP 5, PHP 7)

الدالة stristr()‎ نسخة غير حساس لحالة الأحرف من الدالة strstr()‎.

الوصف

string stristr ( string $haystack , mixed $needle [, bool $before_needle = FALSE ] )

تبحث الدالة stristr()‎ عن أول ظهور للسلسلة النصيَّة needle في السلسلة النصيَّة haystack ثم تعيد جزءًا من هذه السلسلة والتي تبدأ من بداية المعامل needle -الذي عثر عليه أولًا- وحتى نهاية السلسلة.

المعاملات

haystack

السلسلة النصيَّة التي ستبحث الدالة فيها.

needle

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

before_needle

معامل اختياري. إن كانت قيمته TRUE، فستعيد الدالة strstr()‎ جزءًا من السلسلة النصيَّة haysatck الواقع قبل أول ظهور للمعامل needle ولا يكون هذا المعامل ضمن القيمة المعادة.

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

القيم المعادة

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

سجل التغييرات

الإصدار	الوصف
5.3.0	أضيف المعامل الاختياري before_needle.
4.3.0	أصبحتْ الدالة stristr()‎ آمنة ثنائية

أمثلة

المثال 1: مثال على الدالة stristr()‎

<?php
$email = 'USER@EXAMPLE.com';
echo stristr($email, 'e'); // ER@EXAMPLE.com
echo stristr($email, 'e', true); // US بدءًا من الإصدار 5.3.0
?>

المثال 2: اختبار هل عُثِرَ على سلسلة نصية أم لا

<?php
$string = 'Hello World!';
if(stristr($string, 'earth') === FALSE) {
  echo '"earth" not found in string';
}
// "earth" not found in string
?>

المثال 3: استخدام المعامل needle وهو ليس "سلسلة نصية"

<?php
$string = 'APPLE';
echo stristr($string, 97); // 97 = lowercase a
// APPLE
?>

ملاحظات

هذه الدالة آمنة ثنائية.

انظر أيضًا

• الدالة strstr()‎: البحث عن أوّل مطابقة لسلسلة نصية.
• الدالة strrchr()‎: البحث عن آخر مطابقة للحرف في سلسلة نصية.
• الدالة stripos()‎: العثور على أول مطابقة لسلسلة نصية فرعية غير حساسة لحالة الأحرف في سلسلة نصية.
• الدالة strpbrk()‎: البحث عن سلسلة لأي مجموعة من الأحرف.
• الدالة preg_match()‎: إجراء مطابقة عبر التعابير النمطية.

مصادر

• صفحة الدالة stristr‎ في توثيق PHP الرسمي.