الدالة strripos()‎ في PHP

(PHP 5, PHP 7)

تبحث الدالة strripos()‎ عن آخر ظهور لمحارف معينَّة في سلسلة نصيَّة دون تحسُّس حالة الأحرف ثمَّ تعيد رقم موقعها في تلك السلسلة.

الوصف

int strripos ( string $haystack , string $needle [, int $offset = 0 ] )

تبحث هذه الدالة على آخر تواجد للمحارف needle ضمن السلسلة النصيَّة haystack ثمَّ تعيد رقم موقعها في تلك السلسلة. تختلف هذه الدالة عن الدالة strrpos()‎ بأنَّها غير حسَّاسة لحالة الأحرف.

المعاملات

haystack

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

needle

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

offset

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

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

تُعاد قيمة تمثل موقع وجود المعامل needle نسبةً إلى بداية المعامل haystack ودون أخذ قيمة الإزاحة offset أو جهة البحث بالحسبان. إن لم يُعثر على المعامل needle، فستُعاد القيمة FALSE.

تجدر الإشارة إلى أنَّ موقع أول محرف في السلسلة النصيَّة يبدأ من القيمة 0 وليس 1.

تحذير: تعيد أحيانًا هذه الدالة القيمة المنطقيَّة FALSE، وتعيد أحيانًا أخرى قيمة غير منطقيَّة ولكنَّها تعادل القيمة FALSE، لذا استعمل المعامل === للتحقق من القيمة التي تعيدها. يُفضل قراءة قسم القيم المنطقيَّة (boolean) للاطلاع على المزيد من المعلومات.

أمثلة

المثال 1: استعمال الدالة strripos()‎

<?php
$haystack = 'ababcd';
$needle   = 'aB';

$pos      = strripos($haystack, $needle);

if ($pos === false) {
    echo "Sorry, we did not find ($needle) in ($haystack)";
} else {
    echo "Congratulations!\n";
    echo "We found the last ($needle) in ($haystack) at position ($pos)";
}
?>

سيُظهر المثال السابق النتيجة التالية:

  Congratulations!

  We found the last (aB) in (ababcd) at position (2)

انظر أيضًا

• الدالة strpos()‎: تبحث عن أول ظهور لمحارف معينَّة في سلسلة نصيَّة ثمَّ تعيد رقم موقعها في تلك السلسلة.
• الدالة strrpos()‎: تبحث عن آخر ظهور لمحارف معينَّة في سلسلة نصيَّة ثمَّ تعيد رقم موقعها في تلك السلسلة.
• الدالة stripos()‎: تبحث عن أول ظهور لمحارف معينَّة في سلسلة نصيَّة دون تحسُّس حالة الأحرف ثمَّ تعيد رقم موقعها في تلك السلسلة.
• الدالة substr()‎: تعيد جزءًا من السلسلة النصيَّة.
• الدالة strrchr()‎: تبحث عن تواجد محرف معيَّن في سلسلة نصيَّة ثمَّ تعيد ما بعده.
• الدالة stristr()‎: تبحث عن أول ظهور لسلسلة نصيَّة محدَّدة ضمن سلسلة نصيَّة أخرى دون التحسُّس لحالة الأحرف.

مصادر

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