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

ArrayInsertAt

配列に値を挿入します。新しいデータの位置よりも大きなインデックス値を持つ配列要素は、インデックス値が 1 ずつ増やされます。配列の長さは、1 つだけ長くなります。

正常に完了した場合は true

配列関数

ArrayInsertAt(array, position, value)

ArrayDeleteAt

ColdFusion MX:

パラメータ

説明

array

配列の名前です。

position

値を挿入するインデックス位置です。

value

挿入する値です。

この関数で、位置 0 に要素を挿入しようとした場合、または array サイズよりも大きい値を position に指定した場合、InvalidArrayIndexException エラーが返されます。 

<h3>ArrayInsertAt の例</h3><p>
<!--- 新しい配列を作成 --->
<cfset DaysArray = ArrayNew(1)>
<!--- 1 つまたは 2 つの要素を挿入 --->
<cfset DaysArray[1] = "Monday">
<cfset DaysArray[2] = "Tuesday">
<cfset DaysArray[3] = "Thursday">
<!--- 位置 3 の前に要素を追加 --->
<p>位置 3 の前に要素を追加してください。
   <cfoutput>#ArrayInsertAt(DaysArray,3,"Wednesday")#</cfoutput>
<p>ここで、配列をリストとして出力してください。
<cfoutput>#ArrayToList(DaysArray)#</cfoutput>
<!--- 配列の要素が 4 つになりました。要素 3 の "Thursday" が 4 番めの要素になりました。 --->
目 次 > CFML リファレンス > ColdFusion 関数 > ArrayInsertAt O