ARRAYSORT | |
説明
数字またはアルファベットの順番に配列の要素をソートします。 |
|
戻り値
ソートが正常に完了した場合は true、失敗した場合は false |
|
カテゴリ
配列関数、リスト関数 |
|
関数のシンタックスArraySort(array, sort_type [, sort_order ]) |
|
ヒストリ
ColdFusion MX:
たとえば、d,a,a,b,A を textnocase および desc の指定でソートすると、次のようになります。 |
|
パラメータ
|
|
発生エラー
配列要素が単純な要素でない場合、この関数では ArraySortSimpleValueException エラーが返されます。配列要素が数値でない場合に sort_type に numeric を指定すると、ValueNotNumeric エラーが返されます。 |
|
例<!--- この例は、ArraySort の使用方法を示しています。 ---> <cfquery name = "GetEmployeeNames" datasource = "cfdocexamples"> SELECT FirstName, LastName FROM Employees </cfquery> <!--- 配列を作成 ---> <cfset myArray = ArrayNew(1)> <!--- クエリー全体をループし、これらの名前を最後の要素に続けて付加 ---> <cfloop query = "GetEmployeeNames"> <cfset temp = ArrayAppend(myArray, "#FirstName# #LastName#")> </cfloop> <!--- その結果生成された配列をリストとして表示 ---> <cfset myList = ArrayToList(myArray, ",")> <!--- その配列をアルファベット順に降順にソート ---> <cfset isSuccessful = ArraySort(myArray, "textnocase", "desc")> ... |
ARRAY | |
配列の名前です。 |
SORT_TYPE | |
- sort_order = "asc" (昇順) の場合は、aabzABZ となります。 | |
- sort_order = "desc" (降順) の場合は、ZBAzbaa となります。
|
|
- 昇順では、aAaBbBzzZ のように、同じアルファベットが複数ある場合はそれらの元の順序が保 持されます。 | |
-- 降順では、ZzzBbBaAa のように、同じアルファベットでの元の順番は逆になります。 |
SORT_ORDER | |
- 文字の場合、sort_type に指定した値に応じて aabzABZ または aAaBbBzzZ のようにソートさ れます。 | |
- 数値の場合、小さい数から大きい数の順にソートされます。
|
|
- 文字の場合、sort_type の値に応じて ZBAzbaa または ZzzBbBaAa のようにソートされます。 | |
- 数値の場合、大きい数から小さい数の順にソートされます。 |