ARRAYDELETEAT |
説明 配列から要素を削除します。 要素が削除されると、ColdFusion によってインデックス位置が再計算されます。たとえば、1 年の月が含まれている配列から 5 番めの要素を削除すると、5 月のエントリが削除されます。この後で 6 月のエントリを削除するには、6 番めではなく 5 番めの要素を削除することになります。
戻り値 正常に完了した場合は true
カテゴリ 配列関数
関数のシンタックス
    ArrayDeleteAt(array, position)
関連項目 ArrayInsertAt、『ColdFusion MX 開発ガイド』の第35章の「XML および WDDX の使用」 の「XML オブジェクトの管理に使用する関数」
ヒストリ ColdFusion MX: 動作の変更 : この関数は、XML オブジェクトに使用できます。 返される例外の変更 : この関数は、InvalidArrayIndexException エラーを返します。
パラメータ
発生エラー この関数で、位置 0 の要素を削除しようとした場合、または array サイズよりも大きい値を position に指定した場合、InvalidArrayIndexException エラーが返されます。
例
    <h3>ArrayDeleteAt の例</h3><p>
    <!--- 配列を作成 --->
    <cfset DaysArray = ArrayNew(2)>
    <!--- 1 つまたは 2 つの要素を挿入 --->
    <cfset DaysArray[1][1] = "Monday">
    <cfset DaysArray[2][1] = "Tuesday">
    <cfset DaysArray[3][1] = "Wednesday">
    <cfset DaysArray[1][2] = "April 12">
    <cfset DaysArray[2][2] = "April 13">
    <cfset DaysArray[3][2] = "April 14">
    <p>削除前の配列 :<br>
    <cfoutput>
    #DaysArray[1][1]#&nbsp;&nbsp;#DaysArray[1][2]#<br>
    #DaysArray[2][1]#&nbsp;&nbsp;#DaysArray[2][2]#<br>
    #DaysArray[3][1]#&nbsp;&nbsp;#DaysArray[3][2]#<br>
    </cfoutput>

    <cfoutput>
    配列の削除対象の要素 :<br>
    #ArrayDeleteAt(DaysArray,2)#<br>
    </cfoutput>
    <!--- 削除前に 3 番めの要素だった "Wednesday" が 2 番めの要素になっています。 --->
    <p>削除後の配列 :<br>
    <cfoutput>
    #DaysArray[1][1]#&nbsp;&nbsp;#DaysArray[1][2]#<br>
    #DaysArray[2][1]#&nbsp;&nbsp;#DaysArray[2][2]#<br>
    </cfoutput>

ARRAY |
配列の名前です。

POSITION |
配列の位置です。