الفرق بين المراجعتين لصفحة: «PHP/strripos»

المراجعة الحالية بتاريخ 10:57، 8 أبريل 2018

(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 الرسمي.

@@ سطر 25: / سطر 25: @@
 تجدر الإشارة إلى أنَّ موقع أول محرف في السلسلة النصيَّة يبدأ من القيمة 0 وليس 1.
-تحذير: تعيد أحيانًا هذه الدالة القيمة المنطقيَّة <code>FALSE</code>، وتعيد أحيانًا أخرى قيمة غير منطقيَّة ولكنَّها تعادل القيمة <code>FALSE</code>، لذا استعمل المعامل <code>[[PHP/Operators/comparison|===]]</code> للتحقق من القيمة التي تعيدها. يُفضل قراءة قسم [[PHP/Types/boolean|القيم المنطقيَّة]] (boolean) للاطلاع على المزيد من المعلومات.
+تحذير: تعيد أحيانًا هذه الدالة القيمة المنطقيَّة <code>FALSE</code>، وتعيد أحيانًا أخرى قيمة غير منطقيَّة ولكنَّها تعادل القيمة <code>FALSE</code>، لذا استعمل المعامل <code>[[PHP/comparison operators|===]]</code> للتحقق من القيمة التي تعيدها. يُفضل قراءة قسم [[PHP/boolean|القيم المنطقيَّة]] (boolean) للاطلاع على المزيد من المعلومات.
 == أمثلة ==
@@ سطر 51: / سطر 51: @@
 * الدالة <code>[[PHP/strpos|strpos()‎]]</code>: تبحث عن أول ظهور لمحارف معينَّة في سلسلة نصيَّة ثمَّ تعيد رقم موقعها في تلك السلسلة.
 * الدالة <code>[[PHP/strrpos|strrpos()‎]]</code>: تبحث عن آخر ظهور لمحارف معينَّة في سلسلة نصيَّة ثمَّ تعيد رقم موقعها في تلك السلسلة.
-* الدالة <code>[[PHP/Function/stripos|stripos()‎]]</code>: تبحث عن أول ظهور لمحارف معينَّة في سلسلة نصيَّة دون تحسُّس حالة الأحرف ثمَّ تعيد رقم موقعها في تلك السلسلة.
+* الدالة <code>[[PHP/stripos|stripos()‎]]</code>: تبحث عن أول ظهور لمحارف معينَّة في سلسلة نصيَّة دون تحسُّس حالة الأحرف ثمَّ تعيد رقم موقعها في تلك السلسلة.
-* الدالة <code>[[PHP/Function/substr|substr()‎]]</code>: تعيد جزءًا من السلسلة النصيَّة.
+* الدالة <code>[[PHP/substr|substr()‎]]</code>: تعيد جزءًا من السلسلة النصيَّة.
 * الدالة <code>[[PHP/strrchr|strrchr()‎]]</code>: تبحث عن تواجد محرف معيَّن في سلسلة نصيَّة ثمَّ تعيد ما بعده.
-* الدالة <code>[[PHP/Function/stristr|stristr()‎]]</code>: تبحث عن أول ظهور لسلسلة نصيَّة محدَّدة ضمن سلسلة نصيَّة أخرى دون التحسُّس لحالة الأحرف.
+* الدالة <code>[[PHP/stristr|stristr()‎]]</code>: تبحث عن أول ظهور لسلسلة نصيَّة محدَّدة ضمن سلسلة نصيَّة أخرى دون التحسُّس لحالة الأحرف.
 == مصادر ==
 * [http://php.net/manual/en/function.strripos.php صفحة الدالة strripos في توثيق PHP الرسمي.]
 [[تصنيف:PHP]]
+[[تصنيف:PHP Function]]
 [[تصنيف:PHP String]]