الفرق بين المراجعتين ل"PHP/strstr"
ط (←سجل التغييرات: تنسيق الجدول) |
ط (تصحيح التصنيفات) |
||
| (6 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
| سطر 9: | سطر 9: | ||
</syntaxhighlight>تبحث هذه الدالة عن أول ظهور للسلسلة النصيَّة <code>needle</code> في السلسلة النصيَّة <code>haystack</code> ثم تعيد جزءًا من هذه السلسلة والتي تبدأ من بداية المعامل <code>needle</code> -الذي عثر عليه أولًا- وحتى نهاية السلسلة. | </syntaxhighlight>تبحث هذه الدالة عن أول ظهور للسلسلة النصيَّة <code>needle</code> في السلسلة النصيَّة <code>haystack</code> ثم تعيد جزءًا من هذه السلسلة والتي تبدأ من بداية المعامل <code>needle</code> -الذي عثر عليه أولًا- وحتى نهاية السلسلة. | ||
| − | ملاحظة: هذه الدالة حسَّاسة لحالة الأحرف. إن أردت البحث دون تحسُّس حالة الأحرف، فاستعمل الدالة <code>[[PHP | + | ملاحظة: هذه الدالة حسَّاسة لحالة الأحرف. إن أردت البحث دون تحسُّس حالة الأحرف، فاستعمل الدالة <code>[[PHP/stristr|stristr()]]</code>. |
| − | ملاحظة: إن أردت أن تتأكد إن كان المعامل <code>needle</code> موجودًا ضمن السلسلة النصيَّة <code>haystack</code> فقط، فاستعمل الدالة <code>[[PHP | + | ملاحظة: إن أردت أن تتأكد إن كان المعامل <code>needle</code> موجودًا ضمن السلسلة النصيَّة <code>haystack</code> فقط، فاستعمل الدالة <code>[[PHP/strpos|strpos()]]</code> عوضًا عن ذلك إذ هي أسرع أداءً وأقل استهلاكًا للذاكرة. |
== المعاملات == | == المعاملات == | ||
| سطر 52: | سطر 52: | ||
== انظر أيضًا == | == انظر أيضًا == | ||
| − | * الدالة <code>[[PHP/ | + | * الدالة <code>[[PHP/preg_match|preg_match()]]</code>: تبحث عن تعبير نمطي (regular expression) في سلسلة نصيَّة. |
| − | * الدالة <code>[[PHP | + | * الدالة <code>[[PHP/stristr|stristr()]]</code>: تبحث عن أول ظهور لسلسلة نصيَّة محدَّدة ضمن سلسلة نصيَّة أخرى دون تحسُّس حالة الأحرف. |
| − | * الدالة <code>[[PHP | + | * الدالة <code>[[PHP/strpos|strpos()]]</code>: تبحث عن موقع أول ظهور لجزء من سلسلة نصيَّة في سلسلة نصيَّة أخرى. |
| − | * الدالة <code>[[PHP | + | * الدالة <code>[[PHP/strrchr|strrchr()]]</code>: تبحث عن وجود محرف معيَّن في سلسلة نصيَّة ثمَّ تعيد ما بعده. |
| − | * الدالة <code>[[PHP | + | * الدالة <code>[[PHP/strpbrk|strpbrk()]]</code>: تبحث على مجموعة معيَّنة من المحارف ضمن سلسلة نصيَّة. |
== مصادر == | == مصادر == | ||
* [http://php.net/manual/en/function.strstr.php صفحة الدالة strstr في توثيق PHP الرسمي.] | * [http://php.net/manual/en/function.strstr.php صفحة الدالة strstr في توثيق PHP الرسمي.] | ||
[[تصنيف:PHP]] | [[تصنيف:PHP]] | ||
| + | [[تصنيف:PHP Function]] | ||
[[تصنيف:PHP String]] | [[تصنيف:PHP String]] | ||
المراجعة الحالية بتاريخ 10:59، 8 أبريل 2018
(PHP 4, PHP 5, PHP 7)
تبحث الدالة strstr() عن أول ظهور لسلسلة نصيَّة معينة ضمن سلسلة نصيَّة أخرى.
الوصف
string strstr ( string $haystack , mixed $needle [, bool$before_needle = FALSE ] )
تبحث هذه الدالة عن أول ظهور للسلسلة النصيَّة needle في السلسلة النصيَّة haystack ثم تعيد جزءًا من هذه السلسلة والتي تبدأ من بداية المعامل needle -الذي عثر عليه أولًا- وحتى نهاية السلسلة.
ملاحظة: هذه الدالة حسَّاسة لحالة الأحرف. إن أردت البحث دون تحسُّس حالة الأحرف، فاستعمل الدالة stristr().
ملاحظة: إن أردت أن تتأكد إن كان المعامل needle موجودًا ضمن السلسلة النصيَّة haystack فقط، فاستعمل الدالة strpos() عوضًا عن ذلك إذ هي أسرع أداءً وأقل استهلاكًا للذاكرة.
المعاملات
haystack
السلسلة النصيَّة التي ستبحث الدالة فيها.
needle
مجموعة المحارف (السلسلة النصيَّة) التي ستبحث الدالة عنها. إن لم تكن تلك المحارف سلسلةً نصيَّةً، فستُحوَّل إلى عدد صحيح وتُعامل على أنَّها قيمة ترتيبيَّة للمحارف.
before_needle
معامل اختياري. إن كانت قيمته TRUE، فستعيد الدالة strstr() جزءًا من السلسلة النصيَّة haystack الواقع قبل أول ظهور للمعامل needle ولا يكون هذا المعامل ضمن القيمة المعادة.
القيم المعادة
يُعاد جزء من المعامل haystack الواقع بين أول ظهور للمعامل needle في تلك السلسلة وحتى آخرها. إن لم يُعثر على المعامل needle، فستُعاد القيمة FALSE.
سجل التغييرات
| الإصدار | الوصف |
|---|---|
| 5.3.0 | إضافة المعامل الاختياري before_needle.
|
| 4.3.0 | أًصبحت هذه الدالة آمنة ثنائيًّا. |
أمثلة
المثال 1: استعمال الدالة strstr()
<?php
$email = 'name@example.com';
$domain = strstr($email, '@');
echo $domain; // @example.com
$user = strstr($email, '@', true); // الإصدار 5.3.0 وما بعده
echo $user; // name
?>
انظر أيضًا
- الدالة
preg_match(): تبحث عن تعبير نمطي (regular expression) في سلسلة نصيَّة. - الدالة
stristr(): تبحث عن أول ظهور لسلسلة نصيَّة محدَّدة ضمن سلسلة نصيَّة أخرى دون تحسُّس حالة الأحرف. - الدالة
strpos(): تبحث عن موقع أول ظهور لجزء من سلسلة نصيَّة في سلسلة نصيَّة أخرى. - الدالة
strrchr(): تبحث عن وجود محرف معيَّن في سلسلة نصيَّة ثمَّ تعيد ما بعده. - الدالة
strpbrk(): تبحث على مجموعة معيَّنة من المحارف ضمن سلسلة نصيَّة.