PHP substr_compare() 関数

❮ PHP 文字列リファレンス

例

2つの文字列を比較します：

<?php
echo substr_compare("Hello world","Hello world",0);
?>
例の実行 »

定義と用法

substr_compare() 関数は、指定した開始位置から2つの文字列を比較します。

チップ: この関数はバイナリセーフで、オプションで大文字と小文字を区別します。

構文

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

パラメータ 説明
string1 必須。比較する最初の文字列を指定する
string2 必須。比較する2番目の文字列を指定する
startpos 必須。string1 内の比較を開始する位置を指定する。負の場合は、文字列の最後から数える
length 任意。比較するstring1の長さを指定する
case 任意。大文字と小文字を区別する比較を行うかどうかを指定するブール値：
  • FALSE - デフォルト。大文字と小文字を区別する
  • TRUE - 大文字と小文字を区別しない

技術内容
返り値： この関数は次の値を返します：
  • 0 - 2つの文字列が等しい場合
  • <0 - string1（startposから）がstring2より小さい場合
  • >0 - string1（startposから）がstring2より大きい場合
length が string1 の長さ以上の場合、この関数はFALSEを返します。
PHP バージョン： 5+
変更歴 PHP 5.1以降、負の startpos を使用できるようになりました

その他の例

例 1

比較する string1 の開始位置を6文字目とした場合の、2つの文字列を比較する：

<?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 文字列リファレンス