• ColdFusion MX では、d,b,A,a,a が返されます。
  • 以前の ColdFusion のリリースでは、d,b,a,a,A が返されます。
  • 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 の指定でソートすると、次のようになります。

     
    パラメータ

     
    発生エラー

    配列要素が単純な要素でない場合、この関数では 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 となります。
    • textnocase: テキストを、大文字と小文字を区別せずにアルファベット順にソートします。この場合、大文字と小文字に関係なく、アルファベット順にソートされます。
     - 昇順では、aAaBbBzzZ のように、同じアルファベットが複数ある場合はそれらの元の順序が保 持されます。
     -- 降順では、ZzzBbBaAa のように、同じアルファベットでの元の順番は逆になります。
    SORT_ORDER  
     - 文字の場合、sort_type に指定した値に応じて aabzABZ または aAaBbBzzZ のようにソートさ れます。
     - 数値の場合、小さい数から大きい数の順にソートされます。
    • desc - 降順のソートです。
     - 文字の場合、sort_type の値に応じて ZBAzbaa または ZzzBbBaAa のようにソートされます。
     - 数値の場合、大きい数から小さい数の順にソートされます。