PHP substr_compare() 函數

PHP String 參考手冊 PHP String 參考手冊

實例

比較兩個字串：

<?php
echo substr_compare("Hello world","Hello world",0);
?>

定義和用法

substr_compare() 函數從指定的開始位置比較兩個字串。

提示：該函數是二進位安全和選擇性區分大小寫。

語法

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

參數 描述
string1 必需。規定要比較的第一個字串。
string2 必需。規定要比較的第二個字串。
startpos 必需。規定在 string1 中的何處開始比較。如果為負數，則從字串末端開始計數。
length 可選。規定在 string1 中參與比較的字元數。
case 可選。一個布爾值，規定是否執行區分大小寫的比較：
  • FALSE - 默認。區分大小寫
  • TRUE - 不區分大小寫

技術細節

返回值： 該函數返回：
  • 0 - 如果兩字串相等
  • <0 - 如果 string1 （從開始位置 startpos）小於 string2
  • >0 - 如果 string1 （從開始位置 startpos）大於 string2
如果 length 大於或等於 string1 的長度，則該函數返回 FALSE。
PHP 版本： 5+
更新日誌： 自 PHP 5.1 起，允許使用負數的 startpos。

更多實例

實例 1

比較兩個字串，當 string1 中用於比較的開始位置為 6 時：

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


實例 2

使用所有的參數：

<?php
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);
?>


實例 3

不同的返回值：

<?php
echo substr_compare("Hello world!","Hello world!",0); // the two strings are equal
echo substr_compare("Hello world!","Hello",0); // string1 is greater than string2
echo substr_compare("Hello world!","Hello world! Hello!",0); // str1 is less than str2
?>


PHP String 參考手冊 PHP String 參考手冊