PHP substr_compare() 函數

實例

比較兩個字符串:

<?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); // 兩字符串相等
echo substr_compare("Hello world!","Hello",0); // string1 大于 string2
echo substr_compare("Hello world!","Hello world! Hello!",0); // string1 小于 string2
?>

運行實例