パラメーター
最終更新日 :
2021年4月28日
|
次にも適用 : ColdFusion
ListPrepend(list, value [, delimiters, includeEmptyFields ])
履歴
ColdFusion（2018 リリース）アップデート 5：
- 名前付きパラメーターが導入されました。
- 新規パラメーター includeEmptyFields が追加されました。
関連項目
『ColdFusion アプリケーションの開発』のデータ型開発ガイドの ListAppend、ListInsertAt、ListSetAt、Lists
パラメーター
|
|
説明 |
|---|---|
|
list |
リスト、またはリストを含んでいる変数です。 |
|
値 |
要素または要素のリストです。 |
|
delimiters |
文字列、または文字列を含んでいる変数です。リスト要素を区切る文字です。デフォルト値はカンマ（,）です。このパラメータに複数の文字が含まれている場合は、最初の文字だけが使用され、残りは無視されます。 |
|
includeEmptyFields |
リストの先頭に追加されるリストの空のフィールドを含めるかどうかを判断するためのブール値です。 |
使用方法
リストの先頭に要素を挿入すると、区切り文字が付加されます。delimiters に複数の区切り文字が含まれている場合は、最初の文字が区切り文字として使用されます。delimiters を省略した場合は、カンマが使用されます。ColdFusion では空のリスト要素が無視されるので、"a,b,c,,,d" の場合は 4 つの要素があることになります。delimiters パラメータが空の文字列（""）の場合、value パラメータの内容が返されます。
例 1
<cfscript>
myList="Tokyo,Bangkok,Jakarta,Manila,Bangalore,Shanghai";
myAppend=ListPrepend(myList,"Singapore");
WriteOutput(myAppend); // Inserts Singapore at the beginning of the list
</cfscript>
出力
Singapore,Tokyo,Bangkok,Jakarta,Manila,Bangalore,Shanghai
例 2
includeEmptyFields="true" の場合
<cfscript> mylist="John,Paul,George" writeOutput(ListPrepend(list=mylist,value=",,,Ringo,,",delimiter=",",includeEmptyFields="true")) </cfscript>
出力
,,,Ringo,,,John,Paul,George
<cfscript> mylist="Paul,George" writeOutput(ListPrepend(list=mylist,value=",,John,,,Ringo,,",delimiter=",",includeEmptyFields="true")) </cfscript>
出力
,,John,,,Ringo,,,Paul,George
includeEmptyFields="false" の場合
<cfscript> mylist="John,Paul,George" writeOutput(ListPrepend(list=mylist,value=",,,Ringo,,",delimiter=",",includeEmptyFields="false")) </cfscript>
出力
Ringo,John,Paul,George
<cfscript> mylist="Paul,George" writeOutput(ListPrepend(list=mylist,value=",,John,,,Ringo,,",delimiter=",",includeEmptyFields="false")) </cfscript>
出力
Ringo,John,Paul,George
メンバー関数
<cfscript>
mylist="Paul,George"
writeOutput(mylist.ListPrepend(",,John,,,Ringo,,",",","false"))
</cfscript>
出力
John,Ringo,Paul,George
