PHP/strrchr

(PHP 4, PHP 5, PHP 7)

تبحث الدالة strrchr()‎ عن وجود محرف معيَّن في سلسلة نصيَّة ثمَّ تعيد ما بعده.

الوصف

string strrchr ( string $haystack , mixed $needle )

تعيد هذه الدالة جزءًا من السلسلة النصيَّة haystack الذي يبدأ عند نهاية المحرف needle وينتهي عند نهاية تلك السلسلة النصيَّة.

المعاملات

haystach

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

needle

المحرف الذي ستبحث الدالة عنه. إن مُرِّر أكثر من محرف واحد، فستأخذ الدالة المحرف الأول فقط وتستعمله في عملية البحث. يَختلف هذا السلوك عن شبيهه الذي تستعمله الدالة strstr()‎.

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

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

يُعاد الجزء المحصور بين نهاية المعامل needle (إن وُجد) وحتى نهاية المعامل haystack. إن لم يُعثَر على المعامل needle، فستُعاد القيمة FALSE.

جدول التغييرات

الإصدار	الوصف
4.3.0	أصبحت هذه الدالة الآن أمنة ثنائيًّا (binary safe).

أمثلة

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

<?php
//$PATH الحصول على عنوان المجلد الأخير من المسار 
$dir = substr(strrchr($PATH, ":"), 1);

// الحصول على كل شيء موجود بعد السطر الأخير
$text = "Line 1\nLine 2\nLine 3";
$last = substr(strrchr($text, 10), 1 );
?>

ملاحظات

تُعدُّ هذه الدالة آمنة ثنائيًّا (binary safe).

انظر أيضًا

• الدالة strstr()‎: تبحث عن أول ظهور لسلسلة نصيَّة محدَّدة ضمن سلسلة نصيَّة أخرى.
• الدالة strrpos()‎: تبحث عن آخر ظهور لمحارف معينَّة في سلسلة نصيَّة ثمَّ تعيد رقم موقعها في تلك السلسلة.

مصادر

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