PHP マニュアル: "自然順"アルゴリズムにより大文字小文字を区別しない文字列比較を行う

説明

int strnatcasecmp(string $string1, string $string2)

この関数は、人間が行うような手法でアルファベットまたは数字の文字列の順序を比較するアルゴリズムを実装します。この関数の動作は、 strnatcmp に似ていますが、比較が大文字小文字を区別しない違いがあります。詳細な情報については、Martin Pool の » 自然順文字列比較のページを参照ください。

パラメータ

string1: 最初の文字列。
string2: 次の文字列。

戻り値

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

変更履歴

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

例

例1 strnatcasecmp の例

<?php

var_dump(strnatcasecmp('Apple', 'Banana'));
var_dump(strnatcasecmp('Banana', 'Apple'));
var_dump(strnatcasecmp('apple', 'Apple'));
?>

上の例の出力は以下となります。

int(-1)
int(1)
int(0)

参考

preg_match
strcmp
strcasecmp
substr
stristr
strncasecmp
strncmp
strstr
setlocale