パラメーター
最終更新日 :
2021年4月28日
|
次にも適用 : ColdFusion
ListAppend(list, value [, delimiter, includeEmptyFields ])
関連項目
ListPrepend、ListInsertAt、ListGetAt、ListLast、ListSetAt、『ColdFusion アプリケーションの開発』の「リスト」。
履歴
ColdFusion（2018 リリース）アップデート 5：
- 名前付きパラメーターが導入されました。
- 新規パラメーター includeEmptyFields が追加されました。
パラメーター
|
|
説明 |
|---|---|
|
list |
リスト、またはリストを含んでいる変数です。 |
|
value |
要素または要素のリストです。 |
|
delimiters |
（オプション）文字列、または文字列を含んでいる変数です。リスト要素を区切る文字です。デフォルト値はカンマ（,）です。このパラメータに複数の文字が含まれている場合は、最初の文字だけが使用されます。 |
|
includeEmptyFields |
リストの末尾に追加されるリストの空のフィールドを含めるかどうかを判断するためのブール値です。 |
使用方法
ColdFusion では、value の前に区切り文字が挿入されます。次の表は、ListAppend 処理の例を示しています。
ステートメント |
出力 |
コメント |
|---|---|---|
ListAppend('elem1,elem2', '' ) |
elem1,elem2, |
付加される要素は空です。リストの末尾に区切り文字が付加されます。リスト長は 2 です。 |
ListAppend('', 'elem1,elem2' ) |
elem1,elem2 |
リスト長は 2 です。 |
ListAppend("one__two", "three", "__") |
"one two_three" |
"three" の前に、区切り文字として delimiters の最初の文字が挿入されます。 |
例 1
<cfscript>
myList="John,Paul,George,Ringo";
myListAppended=ListAppend(myList,"George Martin",","); // Delimiter is comma
WriteOutput(myListAppended);
</cfscript>
出力
John,Paul,George,Ringo,George Martin
<cfscript>
// define the list
myList="John,Paul,George,Ringo";
myListAppended=ListAppend(myList,"George Martin");
WriteOutput(myListAppended);
</cfscript>
出力
John,Paul,George,Ringo,George Martin
例 3
<cfscript>
myList="John";
myListAppended=ListAppend(myList,"George Martin","|");
WriteOutput(myListAppended);
</cfscript>
出力
John|George Martin
例 3
includeEmptyFields="true" の場合、
<cfscript> mylist="John,Paul,George" writeOutput(ListAppend(list=mylist,value="Ringo,,",delimiter=",",includeEmptyFields="true")) </cfscript>
出力
John,Paul,George,Ringo,,
<cfscript> mylist="John,Paul" writeOutput(ListAppend(list=mylist,value="Ringo,George,",delimiter=",",includeEmptyFields="true")) </cfscript>
出力
John,Paul,Ringo,George,
例 4
includeEmptyFields="false" の場合、
<cfscript> mylist="John,Paul,George" writeOutput(ListAppend(list=mylist,value="Ringo,,",delimiter=",",includeEmptyFields="false")) </cfscript>
出力
John,Paul,George,Ringo
<cfscript> mylist="John,Paul" writeOutput(ListAppend(list=mylist,value="Ringo,George,",delimiter=",",includeEmptyFields="false")) </cfscript>
出力
John,Paul,George,Ringo
メンバー関数
<cfscript>
mylist="John,Paul,,"
writeOutput(mylist.Append("Ringo,George,",",","false"))
</cfscript>
出力
John,Paul,Ringo,George
