PHP substr_compare() Function











❮ مرجع رشته PHP




مثال


دو رشته را مقایسه کنید:




echo substr_compare("Hello world","Hello world",0);

?>

این را خودتان امتحان کنید »



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


تابع substr_compare() دو رشته را از یک موقعیت شروع مشخص مقایسه می کند.


نکته: این تابع باینری ایمن است و به صورت اختیاری به حروف کوچک و بزرگ حساس است.




نحو



substr_compare(string1, string2, startpos, length, case)

مقادیر پارامتر



























پارامتر توضیح
string1 لازم است. اولین رشته را برای مقایسه مشخص می کند
string2 لازم است. رشته دوم را برای مقایسه مشخص می کند
startpos لازم است. مشخص می کند که مقایسه در string1 از کجا شروع شود. اگر منفی باشد، از انتهای رشته شروع به شمارش می کند
طول اختیاری. مشخص می کند که چه مقدار از string1 باید مقایسه شود
مورد اختیاری. یک مقدار بولی که مشخص می کند آیا مقایسه حساس به حروف بزرگ انجام شود یا نه:

  • FALSE - پیش فرض. حساس به حروف کوچک و بزرگ

  • درست - حساس به حروف کوچک و بزرگ










جزئیات فنی














مقدار بازگشتی: این تابع برمی‌گرداند:

  • 0 - اگر دو رشته برابر باشند

  • <0 - اگر string1 (از startpos) کمتر از string2 باشد

  • >0 - اگر string1 (از startpos) بزرگتر از string2 باشد

اگر طول مساوی یا بزرگتر از طول رشته 1 باشد، این تابع FALSE را برمی گرداند.
نسخه PHP: 5+
تغییر: از PHP 5.5.11 - پارامتر length می تواند 0 باشد.
از PHP 5.1، اکنون می توان از startpos منفی استفاده کرد. /td>



نمونه های بیشتر



مثال


دو رشته را مقایسه کنید، زمانی که موقعیت شروع در رشته 1 برای مقایسه ششمین است:




echo substr_compare("سلام جهان","جهان",6);

?>

این را خودتان امتحان کنید »



مثال


استفاده از همه پارامترها:



echo substr_compare("world","or",1,2);
echo substr_compare("world","ld",-2,2);

echo substr_compare("world","orl",1,2);
echo substr_compare("world","OR",1,2,TRUE);

echo substr_compare("world","or",1,3);
echo substr_compare("world","rl",1,2);

?>

این را خودتان امتحان کنید »



مثال


مقادیر بازگشتی متفاوت:



echo substr_compare("سلام دنیا!","سلام دنیا!",0); // دو رشته برابر هستند
echo substr_compare("Hello world!","Hello",0); // string1 بزرگتر از string2 است
echo substr_compare("سلام دنیا!","سلام دنیا! سلام!",0); // str1 کمتر از str2 است

?>

این را خودتان امتحان کنید »


❮ مرجع رشته PHP