strncmp

(PHP 4, PHP 5, PHP 7, PHP 8)

strncmp最初の n 文字についてバイナリセーフな文字列比較を行う

説明

strncmp(string $string1, string $string2, int $length): int

この関数は strcmp() に似ていますが、 各文字列から(最大)文字数(len) を比較に使用するところが異なります。

比較は大文字小文字を区別することに注意してください。

パラメータ

string1

最初の文字列。

string2

次の文字列。

length

比較する文字数。

戻り値

string1string2 より小さい場合に -1string1string2 より大きい場合に 1、等しい場合に 0 を返します。

変更履歴

バージョン 説明
8.2.0 これより前のバージョンで負の数と正の数を返していた場合に、 この関数は -11 を返すようになりました。

例1 strncmp() の例

<?php

$var1
= 'Hello John';
$var2 = 'Hello Doe';
if (
strncmp($var1, $var2, 5) === 0) {
echo
'First 5 characters of $var1 and $var2 are equals in a case-sensitive string comparison';
}
?>

参考

  • strncasecmp() - バイナリセーフで大文字小文字を区別しない文字列比較を、最初の n 文字について行う
  • preg_match() - 正規表現によるマッチングを行う
  • substr_compare() - 指定した位置から指定した長さの 2 つの文字列について、バイナリ対応で比較する
  • strcmp() - バイナリセーフな文字列比較
  • strstr() - 文字列が最初に現れる位置を見つける
  • substr() - 文字列の一部分を返す