PHP substr_compare()関数

PHP String 参考手册PHP String リファレンスマニュアル

例

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

2つの文字列を比較し、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 リファレンスマニュアル その他の拡張