ArrayObject::natcasesort

大文字小文字を区別しない "自然順" アルゴリズムでエントリをソートする

説明

public true ArrayObject::natcasesort()

このメソッドは、大文字小文字を区別しない ArrayObject::natsort です。

このメソッドは、英数字からなる文字列を人間が並び替えるのと同じようなアルゴリズムでソートし、キーと値の対応は保持します。このようなソートのことを "自然順" と呼びます。

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

パラメータ

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

戻り値

値を返しません。

変更履歴

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

例

例1 ArrayObject::natcasesort の例

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

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

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

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

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

Standard sorting
object(ArrayObject)#1 (1) {
  ["storage":"ArrayObject":private]=>
  array(6) {
    [0]=>
    string(8) "IMG0.png"
    [5]=>
    string(8) "IMG3.png"
    [4]=>
    string(8) "img1.png"
    [2]=>
    string(9) "img10.png"
    [1]=>
    string(9) "img12.png"
    [3]=>
    string(8) "img2.png"
  }
}

Natural order sorting (case-insensitive)
object(ArrayObject)#2 (1) {
  ["storage":"ArrayObject":private]=>
  array(6) {
    [0]=>
    string(8) "IMG0.png"
    [4]=>
    string(8) "img1.png"
    [3]=>
    string(8) "img2.png"
    [5]=>
    string(8) "IMG3.png"
    [2]=>
    string(9) "img10.png"
    [1]=>
    string(9) "img12.png"
  }
}

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

参考

ArrayObject::asort
ArrayObject::ksort
ArrayObject::natsort
ArrayObject::uasort
ArrayObject::uksort
natcasesort