ArrayObject::natsort

(PHP 5 >= 5.2.0, PHP 7, PHP 8)

ArrayObject::natsort"自然順" アルゴリズムでエントリをソートする

説明

public ArrayObject::natsort(): bool

このメソッドは、英数字からなる文字列を人間が並び替えるのと同じようなアルゴリズムでソートし、 キーと値の対応は保持します。このようなソートのことを "自然順" と呼びます。 このアルゴリズムと、コンピュータの通常の文字列ソートアルゴリズム (ArrayObject::asort で使われているもの) の違いは、以下のサンプルを参照ください。

注意:

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

パラメータ

この関数にはパラメータはありません。

戻り値

値を返しません。

例1 ArrayObject::natsort() の例

<?php
$array 
= array("img12.png""img10.png""img2.png""img1.png");

$arr1 = new ArrayObject($array);
$arr2 = clone $arr1;

$arr1->asort();
echo 
"Standard sorting\n";
print_r($arr1);

$arr2->natsort();
echo 
"\nNatural order sorting\n";
print_r($arr2);
?>

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

Standard sorting
ArrayObject Object
(
    [3] => img1.png
    [1] => img10.png
    [0] => img12.png
    [2] => img2.png
)

Natural order sorting
ArrayObject Object
(
    [3] => img1.png
    [2] => img2.png
    [1] => img10.png
    [0] => img12.png
)

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

参考

関連キーワード:  ソート, ArrayObject, アルゴリズム, エントリ, natsort, キー, 関数, 比較, 保持, Object