ARRAYDELETEAT | |
説明
配列から要素を削除します。 要素が削除されると、ColdFusion によってインデックス位置が再計算されます。たとえば、1 年の月が含まれている配列から 5 番めの要素を削除すると、5 月のエントリが削除されます。この後で 6 月のエントリを削除するには、6 番めではなく 5 番めの要素を削除することになります。 |
|
戻り値
正常に完了した場合は true |
|
カテゴリ
配列関数 |
|
関数のシンタックスArrayDeleteAt(array, position) |
|
関連項目
ArrayInsertAt、『ColdFusion MX 開発ガイド』の第35章の「XML および WDDX の使用」 の「XML オブジェクトの管理に使用する関数」 |
|
ヒストリ
ColdFusion MX:
|
|
パラメータ
|
|
発生エラー
この関数で、位置 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]# #DaysArray[1][2]#<br> #DaysArray[2][1]# #DaysArray[2][2]#<br> #DaysArray[3][1]# #DaysArray[3][2]#<br> </cfoutput> <cfoutput> 配列の削除対象の要素 :<br> #ArrayDeleteAt(DaysArray,2)#<br> </cfoutput> <!--- 削除前に 3 番めの要素だった "Wednesday" が 2 番めの要素になっています。 ---> <p>削除後の配列 :<br> <cfoutput> #DaysArray[1][1]# #DaysArray[1][2]#<br> #DaysArray[2][1]# #DaysArray[2][2]#<br> </cfoutput> |
ARRAY | |
配列の名前です。 |
POSITION | |
配列の位置です。 |