ListAppend

説明

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

戻り値

value が付加されたリストのコピー。value = "" の場合は、コピーのリストがそのまま返されます。

カテゴリ

リスト関数

関数のシンタックス

ListAppend(list, value [, delimiters ])

関連項目

ListPrependListInsertAtListGetAtListLastListSetAt、『ColdFusion アプリケーションの開発』のLists

パラメータ

パラメータ

説明

list

リスト、またはリストを含んでいる変数です。

value

要素または要素のリストです。

delimiters

文字列、または文字列を含んでいる変数です。リスト要素を区切る文字です。デフォルト値はカンマ (,) です。

このパラメータに複数の文字が含まれている場合は、最初の文字だけが使用されます。

使用方法

ColdFusion では、value の前に区切り文字が挿入されます。

次の表は、ListAppend 処理の例を示しています。

ステートメント

出力

コメント

ListAppend('elem1,elem2', '' )

elem1,elem2,

付加される要素は空です。リストの末尾に区切り文字が付加されます。リスト長は 2 です。

ListAppend('', 'elem1,elem2' )

elem1,elem2

リスト長は 2 です。

ListAppend("one___two", "three", "___")

"one___two_three"

"three" の前に、区切り文字として delimiters の最初の文字が挿入されます。

<h3>ListAppend Example</h3> 
<!--- First, query to get some values for our list elements---> 
<cfquery name = "GetParkInfo" datasource = "cfdocexamples"> 
    SELECT PARKNAME,CITY,STATE 
    FROM PARKS WHERE PARKNAME LIKE 'AL%' 
</cfquery> 
<cfset temp = ValueList(GetParkInfo.ParkName)> 
<cfoutput> 
<p>The original list: #temp# 
</cfoutput> 
<!--- now, append a park name to the list ---> 
<cfset temp2 = ListAppend(Temp, "ANOTHER PARK")>