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