LISTPREPEND  
説明

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

 
戻り値

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

 
カテゴリ

リスト関数

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

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

 
パラメータ

 
使用方法

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

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

delimiters パラメータが空の文字列 ("") の場合、value パラメータの内容が返されます。

 
<!--- この例は、ListPrepend の使用方法を示しています。 --->
<cfquery name = "GetParkInfo" datasource = "cfdocexamples">
   SELECT PARKNAME,CITY,STATE
   FROM PARKS
   WHERE PARKNAME LIKE 'DE%'
</cfquery>
<cfset temp = ValueList(GetParkInfo.ParkName)>
<cfset first_element = ListFirst(temp)>
<cfoutput><p>元のリスト : #temp#</cfoutput>
<!--- ここで、位置 1 に要素を挿入 --->
<cfset temp2 = ListPrepend(Temp, "挿入する値")>
LIST  
リスト、またはリストを含んでいる変数です。
VALUE  
要素または要素のリストです。
DELIMITERS  
文字列、または文字列を含んでいる変数です。リスト要素の区切り文字を指定します。デフォルト 値はカンマ (,) です。
このパラメータに複数の文字が含まれている場合は、最初の文字だけが使用され、残りは無視され ます。