LISTINSERTAT  
説明

リストに要素を挿入します。

 
戻り値

指定された位置に value が挿入されたリストのコピー

 
カテゴリ

リスト関数

 
関数のシンタックス
ListInsertAt(list, position, value [, delimiters ])
 
関連項目

ListDeleteAt、ListAppend、ListPrepend、ListSetAt、『ColdFusion MX 開発ガイド』の第3章の「ColdFusion 変数の使用」 の「リスト」

 
パラメータ

 
使用方法

要素を挿入すると、区切り文字が付加されます。delimiters に複数の区切り文字が含まれている場合は、最初の文字が区切り文字として使用されます。delimiters を省略した場合はカンマが使用されます。

ColdFusion では空のリスト要素が無視されるため、"a,b,c,,,d" の場合は 4 つの要素があることになります。

 
<!--- この例は、ListInsertAt の使用方法を示しています。 --->
<cfquery name = "GetParkInfo" datasource = "cfdocexamples">
SELECT PARKNAME,CITY,STATE
FROM PARKS
WHERE PARKNAME LIKE `DE%'
</cfquery>
<cfset temp = ValueList(GetParkInfo.ParkName)>
<cfset insert_at_this_element = ListGetAt(temp, "3", ",")>
<cfoutput>
<p>元のリスト : #temp#
</cfoutput>
<cfset temp2 = ListInsertAt(Temp, "3", "挿入する値")>
LIST  
リスト、またはリストを含んでいる変数です。
POSITION  
正の整数、または正の整数を含んでいる変数です。要素を挿入する位置を指定します。リスト内の 先頭を示す位置は 1 です。
VALUE  
要素または要素のリストです。
DELIMITERS  
文字列、または文字列を含んでいる変数です。リスト要素の区切り文字を指定します。デフォルト 値はカンマ (,) です。
このパラメータに複数の文字が含まれている場合、それぞれの文字が出現するすべての箇所が区切 り文字として処理されます。