大文字小文字を区別しないバイナリセーフな文字列比較を行う

# strcasecmp

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

strcasecmp — 大文字小文字を区別しないバイナリセーフな文字列比較を行う

### 説明

function strcasecmp(string `$string1`, string `$string2`): int

大文字小文字を区別しないバイナリセーフな文字列比較を行います。 ここで行う比較は、ロケールを考慮しません。 つまり、ASCII文字だけが、大文字小文字を区別せず比較されます。

### パラメータ

`string1`

  最初の文字列。

`string2`

  次の文字列。

### 戻り値

`string1` が `string2` より小さければ 0 より小さな値を、 `string1` が `string2` より大きければ 0 より大きな値を、 両者が等しければ `0` を返します。 返却される値の絶対値に、特に意味はありません。

### 変更履歴

バージョン | 説明
--- | ---
8.2.0 | この関数は、2つの文字列の長さが等しくない場合に `strlen($string1) - strlen($string2)` を返すとは限らなくなりました。 代わりに、`-1` や `1` を返す可能性があります。

### 例

例1 strcasecmp() の例

    <?php
    $var1 = "Hello";
    $var2 = "hello";
    if (strcasecmp($var1, $var2) == 0) {
        echo '$var1 is equal to $var2 in a case-insensitive string comparison';
    }
    ?>

### 参考

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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open