update page now

    natcasesort

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

    natcasesort — 大文字小文字を区別しない"自然順"アルゴリズムを用いて配列をソートする

    説明

    natcasesort(array &$array): true

    natcasesort() は、大文字小文字を区別しないバージョンの natsort() です。

    この関数は、人間が行うような手法でアルファベットまたは数字の文字列の順番を キー/値の関係を保持したままソートします。 これは、"自然順(natural ordering)"と呼ばれているものです。

    注意:

    比較結果が等しくなる二つの要素があった場合、それらの並び順は保持されます。PHP 8.0.0 より前のバージョンでは、ソートした配列におけるそれらの並び順は不定でした。

    注意:

    この関数をコールすると、配列の内部ポインタは最初の要素にリセットされます。

    パラメータ

    array

    入力の配列。

    戻り値

    常に true を返します。

    変更履歴

    バージョン 説明
    8.2.0 戻り値の型が、true になりました。これより前のバージョンでは、bool でした。

    例

    例1 natcasesort() の例

    <?php
    $array1     = $array2 = array('IMG0.png', 'img12.png', 'img10.png', 'img2.png', 'img1.png', 'IMG3.png');

    sort($array1);
    echo     "Standard sorting\n";
    print_r($array1);

    natcasesort($array2);
    echo     "\nNatural order sorting (case-insensitive)\n";
    print_r($array2);
    ?>

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

    Standard sorting
Array
(
    [0] => IMG0.png
    [1] => IMG3.png
    [2] => img1.png
    [3] => img10.png
    [4] => img12.png
    [5] => img2.png
)

Natural order sorting (case-insensitive)
Array
(
    [0] => IMG0.png
    [4] => img1.png
    [3] => img2.png
    [5] => IMG3.png
    [2] => img10.png
    [1] => img12.png
)

    より詳細な情報については、Martin Poolの » Natural Order String Comparison ページを参照ください。

    参考

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 1 note

    up
    46
    dslicer at maine dot rr dot com
    22 years ago
    Something that should probably be documented is the fact that both natsort and natcasesort maintain the key-value associations of the array. If you natsort a numerically indexed array, a for loop will not produce the sorted order; a foreach loop, however, will produce the sorted order, but the indices won't be in numeric order. If you want natsort and natcasesort to break the key-value associations, just use array_values on the sorted array, like so:

natcasesort($arr);
$arr = array_values($arr);
    ＋add a note
    To Top