説明

リストまたは要素をリストに付加します。

戻り値

文字列です。

カテゴリ

リスト関数

関数のシンタックス

ListAppend(list, value [, delimiter, includeEmptyFields ])

関連項目

ListPrependListInsertAtListGetAtListLastListSetAt、『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

例 2

 

<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

本作品は Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License によってライセンス許可を受けています。  Twitter™ および Facebook の投稿には、Creative Commons の規約内容は適用されません。

リーガルノーティス   |   プライバシーポリシー