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 | |
文字列、または文字列を含んでいる変数です。リスト要素の区切り文字を指定します。デフォルト 値はカンマ (,) です。 | |
このパラメータに複数の文字が含まれている場合は、最初の文字だけが使用され、残りは無視され ます。 |