ColdFusion MX
目 次 > CFML リファレンス > ColdFusion 関数 > ArraySort O

ArraySort

数字またはアルファベットの順番に配列の要素をソートします。

ソートが正常に完了した場合は true、失敗した場合は false

配列関数、リスト関数

ArraySort(array, sort_type [, sort_order ])

ColdFusion MX:

パラメータ

説明

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 のようにソートされます。
  • 数値の場合、大きい数から小さい数の順にソートされます。

配列要素が単純な要素でない場合、この関数では ArraySortSimpleValueException エラーが返されます。配列要素が数値でない場合に sort_type に numeric を指定すると、ValueNotNumeric エラーが返されます。

<!--- この例は、ArraySort の使用方法を示しています。 --->
<cfquery name = "GetEmployeeNames" datasource = "cfsnippets">
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")>
...
目 次 > CFML リファレンス > ColdFusion 関数 > ArraySort O