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  
配列の位置です。