ARRAYSORT |
説明 数字またはアルファベットの順番に配列の要素をソートします。
戻り値 ソートが正常に完了した場合は true、失敗した場合は false
カテゴリ 配列関数、リスト関数
関数のシンタックス
    ArraySort(array, sort_type [, sort_order ])
ヒストリ ColdFusion MX: 返された例外の変更 : この関数は、ArraySortSimpleValueException エラーおよび ValueNotNumeric エラーを返します。 要素のソート順の変更 : textnocase の降順でソートした場合、以前のリリースと異なるソート順で要素を返すことがあります。sort_type = "textnocase"、および sort_order = "desc" である場合、大文字と小文字の違いだけがある要素については、ColdFusion MX と以前のリリースでは次のように処理が異なります。 ColdFusion MX では要素の元の順番が逆になります。 以前の ColdFusion のリリースでは、要素の元の順番は変更されません。 たとえば、d,a,a,b,A を textnocase および desc の指定でソートすると、次のようになります。
- ColdFusion MX では、d,b,A,a,a が返されます。
- 以前の ColdFusion のリリースでは、d,b,a,a,A が返されます。
パラメータ
発生エラー 配列要素が単純な要素でない場合、この関数では 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 |

- numeric: 数値をソートします。
- text: テキストを、大文字と小文字を区別してアルファベット順にソートします。大文字と小文字は分けられ、別々にソートされて並べられます。

- sort_order = "asc" (昇順) の場合は、aabzABZ となります。
- sort_order = "desc" (降順) の場合は、ZBAzbaa となります。 textnocase: テキストを、大文字と小文字を区別せずにアルファベット順にソートします。この場合、大文字と小文字に関係なく、アルファベット順にソートされます。
- 昇順では、aAaBbBzzZ のように、同じアルファベットが複数ある場合はそれらの元の順序が保 持されます。
-- 降順では、ZzzBbBaAa のように、同じアルファベットでの元の順番は逆になります。

SORT_ORDER |

- asc - 昇順のソートです (デフォルト)。

- 文字の場合、sort_type に指定した値に応じて aabzABZ または aAaBbBzzZ のようにソートさ れます。
- 数値の場合、小さい数から大きい数の順にソートされます。 desc - 降順のソートです。
- 文字の場合、sort_type の値に応じて ZBAzbaa または ZzzBbBaAa のようにソートされます。
- 数値の場合、大きい数から小さい数の順にソートされます。