تابع substr() PHP

مثال

"world" را از رشته بازمی‌گرداند:

<?php
echo substr("Hello world",6);
?>

اجرای نمونه

تعریف و استفاده

تابع substr() بخشی از رشته را برمی‌گرداند.

توضیح:اگر start پارامتر منفی است و length کمتر از یا برابر با start، پس length به 0.

نوع دستور

class="language-php">substr(string,sta rt,length)
پارامتر توضیح
string ضروری. رشته‌ای که بخشی از آن را باید بازگرداند را مشخص می‌کند.
start

ضروری. مکان شروع در رشته را مشخص می‌کند.

  • عدد مثبت - از مکان مشخص شده شروع می‌کند
  • عدد منفی - از مکان مشخص شده از انتها شروع می‌کند
  • عدد صفر - از اولین کاراکتر رشته شروع می‌کند
length

اختیاری. طول رشته‌ای که باید بازگردانده شود را مشخص می‌کند. پیش‌فرض تا پایان رشته است.

  • عدد مثبت - از start طول بازمی‌گردانده شده از مکان پارامتر
  • عدد منفی - از طول رشته در انتها بازمی‌گردد

جزئیات فنی

مقدار بازگشتی: بخش‌های استخراج شده از رشته را برمی‌گرداند، اگر شکست بخورد FALSE برمی‌گرداند، یا یک رشته خالی برمی‌گرداند.
نسخه PHP: 4+
گزارش به‌روزرسانی‌ها:

در نسخه‌های PHP 5.2.2 تا 5.2.6، اگر start اگر پارامتر نشان‌دهنده قطع منفی یا مکان فراتر از محدوده باشد، FALSE برمی‌گرداند.

در نسخه‌های دیگر از start از مکان شروع به دریافت رشته.

بیشتر مثال‌ها

مثال 1

با استفاده از اعداد مثبت و منفی مختلف start پارامترها:

<?php
echo substr("Hello world",10)."<br>";
echo substr("Hello world",1)."<br>";
echo substr("Hello world",3)."<br>";
echo substr("Hello world",7)."<br>";
echo substr("Hello world",-1)."<br>";
echo substr("Hello world",-10)."<br>";
echo substr("Hello world",-8)."<br>";
echo substr("Hello world",-4)."<br>";
?>

اجرای نمونه

مثال ۲

با استفاده از اعداد مثبت و منفی مختلف start و length پارامترها:

<?php
echo substr("Hello world",0,10)."<br>";
echo substr("Hello world",1,8)."<br>";
echo substr("Hello world",0,5)."<br>";
echo substr("Hello world",6,6)."<br>";
echo substr("Hello world",0,-1)."<br>";
echo substr("Hello world",-10,-2)."<br>";
echo substr("Hello world",0,-6)."<br>";
echo substr("Hello world",-2-3)."<br>";
?>

اجرای نمونه