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 |
文字列、または文字列を含んでいる変数です。リスト要素の区切り文字を指定します。デフォルト 値はカンマ (,) です。
このパラメータに複数の文字が含まれている場合、それぞれの文字が出現するすべての箇所が区切 り文字として処理されます。