strpbrk
تابع strpbrk در PHP یک رشته را می گردد. هرجا یکی از کاراکترهای هدف را دید، بقیه رشته را برمی گرداند. ساده بگویم: مثل پیدا کردن اولین "حرف مجاز" در متن. کاراکتر (Character) یعنی یک حرف یا نشانه. کلیدواژه سئو: تابع strpbrk در PHP.
تعریف و کاربرد (strpbrk)
تابع strpbrk(string, charlist) رشته را برای هر کاراکتر موجود در charlist می گردد. این تابع حساس به حروف است. اگر چیزی پیدا شود، از همانجا تا انتهای رشته را برمی گرداند. اگر پیدا نشود، مقدار FALSE برمی گردد.
سینتکس (Syntax)
strpbrk(string $string, string $charlist): string|false
ورودی ها
- string: رشته اصلی برای جستجو.
- charlist: فهرست کاراکترهای مجاز برای پیدا کردن.
خروجی
- اگر پیدا شود: زیررشته از کاراکتر پیدا شده تا پایان.
- اگر پیدا نشود: مقدار
FALSE.
مثال ساده: یافتن اولین یکی از چند حرف
اینجا به دنبال یکی از حروف o یا e می گردیم.
<?php
echo strpbrk("Hello world!", "oe");
?>
حساسیت به حروف بزرگ و کوچک
تابع case-sensitive است؛ یعنی W با w فرق دارد.
<?php
echo strpbrk("Hello world!", "W");
echo "<br>";
echo strpbrk("Hello world!", "w");
?>
نکات مهم و کاربردی
- اگر هیچ کاراکتری یافت نشود، خروجی
FALSEاست. - برای تفاوت حروف، حتماً نوع حرف را دقیق بده.
- این تابع از PHP 5+ در دسترس است.
گام های سریع استفاده
- رشته اصلی را مشخص کن.
- فهرست کاراکترهای هدف را تعیین کن.
- تابع را صدا بزن و خروجی را بررسی کن.
نکته: می خواهی فقط مکان اولین تطبیق را؟ ابزارهای مکان یاب دیگر را در نظر بگیر.
جمع بندی سریع
- strpbrk اولین یکی از چند حرف را می یابد.
- از همان نقطه تا آخر را برمی گرداند.
- حساس به بزرگی و کوچکی حروف است.
- اگر پیدا نشود، مقدار FALSE می دهد.