PHP マニュアル: "自然順"アルゴリズムにより文字列比較を行う

説明

int strnatcmp(string $string1, string $string2)

この関数は、人間が行うような手法でアルファベットまたは数字の文字列の順序を比較するアルゴリズムを実装します。この手法は、"自然順" と言われます。この比較は、大文字小文字を区別することに注意してください。

パラメータ

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

戻り値

他の文字列比較関数と同様に、この関数は、 string1 が string2 より小さいに場合に -1、string1 が string2 より大きい場合に 1、等しい場合に 0 を返します。

変更履歴

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

例

このアルゴリズムと (strcmp を使用した) 通常のコンピュータ文字列ソートの間の違いの例を次に示します。


<?php
$arr1 = $arr2 = array("img12.png", "img10.png", "img2.png", "img1.png");
echo "標準の文字列比較\n";
usort($arr1, "strcmp");
print_r($arr1);
echo "\n自然順での文字列比較\n";
usort($arr2, "strnatcmp");
print_r($arr2);
?>

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

標準の文字列比較
Array
(
    [0] => img1.png
    [1] => img10.png
    [2] => img12.png
    [3] => img2.png
)

自然順での文字列比較
Array
(
    [0] => img1.png
    [1] => img2.png
    [2] => img10.png
    [3] => img12.png
)

詳細な情報については、Martin Pool の » 自然順文字列比較のページを参照ください。

参考

preg_match
strcasecmp
substr
stristr
strcmp
strncmp
strncasecmp
strnatcasecmp
strstr
natsort
natcasesort