LISTSETAT  
説明

リスト要素の内容を置換します。

 
戻り値

指定された位置の要素に新しい値を代入したリストのコピー

 
カテゴリ

リスト関数

 
関数のシンタックス
ListSetAt(list, position, value [, delimiters ])
 
関連項目

ListDeleteAt、ListGetAt、ListInsertAt、『ColdFusion MX 開発ガイド』の第3章の「ColdFusion 変数の使用」 の「リスト」

 
ヒストリ

ColdFusion MX: 区切り文字の修正に関する変更 : ColdFusion MX では、リスト内の区切り文字は修正されません (以前のリリースでは、区切り文字が delimiters パラメータの最初の文字で置き換えられる場合がありました)。

 
パラメータ

 
使用方法

リスト要素に値を設定すると、区切り文字が付加されます。delimiters に複数の区切り文字が含まれている場合は、最初の文字が区切り文字として使用されます。delimiters を省略した場合はカンマが使用されます。

ColdFusion では空のリスト要素が無視されるため、"a,b,c,,,d" の場合は 4 つの要素があることになります。

 
<h3>ListSetAt の例</h3>
<!--- メッセージを書き込んだユーザーのリストを検索 --->
<cfquery name = "GetMessageUser" datasource = "cfdocexamples">
SELECT Username, Subject, Posted
FROM  Messages
</cfquery>

<cfset temp = ValueList(GetMessageUser.Subject)>

<!--- リスト全体をループし、ListGetAt を使用してそれを表示 --->
<h3>これは、メッセージで送信された <cfoutput>#ListLen(temp)#</cfoutput> 件の
件名のリストです。</h3>

<cfset ChangedElement = ListGetAt(temp, 2)>
<cfset TempToo = ListSetAt(temp, 2, "I changed this subject", ",")>
<ul>
<cfloop From = "1" To = "#ListLen(temptoo)#" INDEX = "Counter">
   <cfoutput><li>(#Counter#) 件名 : #ListGetAt(temptoo, Counter)#
   </cfoutput>
</cfloop>
</ul>
<p>要素 2 が ListSetAt によって "<cfoutput>#changedElement#</cfoutput>" から 
"I changed this subject" に変更されています。
LIST  
リスト、またはリストを含んでいる変数です。
POSITION  
正の整数、または正の整数を含んでいる変数です。値を設定する位置を指定します。リスト内の先 頭を示す位置は 1 です。
VALUE  
要素または要素のリストです。
DELIMITERS  
文字列、または文字列を含んでいる変数です。リスト要素の区切り文字を指定します。デフォルト 値はカンマ (,) です。
このパラメータに複数の文字が含まれている場合、それぞれの文字が出現するすべての箇所が区切 り文字として処理されます。