strcspn
این تابع برای شمارش فاصله تا کاراکتر به کار می رود. یعنی می گوید چند حرفِ اولِ رشته، هیچ کدام از حروفِ هدف را ندارند. رشته (String) یعنی متن؛ کاراکتر (Character) یعنی یک حرف یا علامت.
تعریف و کاربرد
strcspn(string, char, start, length) تعداد کاراکترهای ابتداییِ string را برمی گرداند که قبل از یافتن هر بخشی از مجموعه char هستند. این تابع binary-safe است؛ یعنی با داده باینری هم درست کار می کند.
سینتکس و پارامترها
- string: رشته ورودی برای جستجو.
- char: فهرست کاراکترهای هدف برای توقف.
- start: از کجای رشته شروع شود.
- length: چه محدوده ای بررسی شود.
مثال پایه
<?php
echo strcspn("Hello world!", "w");
?>
مثال با start و length
در این مثال از موقعیت 0 تا طول 6 بررسی می شود.
<?php
echo strcspn("Hello world!", "w", 0, 6);
?>
کاربرد ذهنی با مثال مدرسه
فرض کن دفتر مشق داری. تا وقتی به حرفِ «و» نرسیدی، می شماری. strcspn همان تعداد خطوطِ بدون «و» را می دهد. بنابراین، برای یافتن فاصله امن تا یک علامت، عالی است.
ارتباط با توابع مرتبط
strspn برعکس عمل می کند؛ یعنی از کاراکترهای لیست شروع می کند. برای مقایسه ساده رشته ها هم می توانی از strcmp کمک بگیری.
نکته: برای لینک داخلیِ آموزشی، این عبارت را دنبال کن: شمارش فاصله تا کاراکتر.
جمع بندی سریع
- شمارش فاصله تا کاراکترِ هدف را می دهد.
- پارامترهای اختیاری:
startوlength. - رفتار binary-safe دارد.
- برای الگوهای توقف سریع عالی است.