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

(PHP 4, PHP 5, PHP 7)

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

الوصف

string strpbrk ( string $haystack , string $char_list )

تبحث هذه الدالة على مجموعة المحارف char_list ضمن السلسلة النصيَّة haystack.

المعاملات

haystack

السلسلة النصيَّة التي ستبحث الدالة فيها على المحارف char_list.

char_list

مجموعة المحارف التي ستبحث الدالة عنها، وهي حسَّاسة لحالة الأحرف.

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

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

أمثلة

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

<?php

$text = 'This is a Simple text.';

// أولًا 'i' لأنَّها وجدت المحرف "is is a Simple text." ستُظهر السلسلة النصيَّة 
echo strpbrk($text, 'mi');

// لأنَّها حسَّاسة لحالة الأحرف "Simple text." ستُظهر السلسلة النصيَّة 
echo strpbrk($text, 'S');
?>

انظر أيضًا

• الدالة preg_match()‎: تبحث عن تعبير نمطي (regular expression) في سلسلة نصيَّة.
• الدالة strstr()‎: تبحث عن أول ظهور لسلسلة نصيَّة محدَّدة ضمن سلسلة نصيَّة أخرى.
• الدالة strpos()‎: تبحث عن موقع أول ظهور لجزء من سلسلة نصيَّة في سلسلة نصيَّة أخرى.

مصادر

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