LISTGETAT | |
説明
指定された位置にあるリスト要素のインデックスを取得します。 |
|
戻り値
position に位置するリスト要素のインデックス |
|
カテゴリ
リスト関数 |
|
関数のシンタックスListGetAt(list, position [, delimiters ]) |
|
関連項目
ListFirst、ListLast、ListQualify、ListSetAt、『ColdFusion MX 開発ガイド』の第3章の「ColdFusion 変数の使用」 の「リスト」 |
|
パラメータ
|
|
使用方法
文字列の中で区切り文字の後にスペースが付加されている場合、リスト関数を使用すると、返されるリスト要素の先頭にスペースが含まれることがあります。このような場合は、trim 関数を使用して、返された要素からスペースを削除します。たとえば、次のようなリストがこれに該当します。 <cfset myList = "one hundred, two hundred, three hundred"> このリストから値を取得するには、trim 関数を使用して、戻り値の先頭にあるスペースを削除します。 <cfset MyValue = #trim(listGetAt(myList, 2))#> これにより、MyValue = " two hundred" ではなく "two hundred" となります。リスト要素の途中にあるスペースは保持されます。 ColdFusion では空のリスト要素が無視されるため、"a,b,c,,,d" の場合は 4 つの要素があることになります。 |
|
例<h3>ListGetAt の例</h3> <!--- メッセージを書き込んだユーザーのリストを検索 ---> <cfquery name = "GetMessageUser" datasource = "cfdocexamples"> SELECT Username, Subject, Posted FROM Messages </cfquery> <cfset temp = ValueList(GetMessageUser.Username)> <!--- リスト全体をループし、ListGetAt を使用してそれを表示 ---> <h3>メッセージを送信したユーザーの名前のリストには、 <cfoutput>#ListLen(temp)#</cfoutput> 名のユーザーが含まれています。</h3> <ul> <cfloop From = "1" To = "#ListLen(temp)#" index = "Counter"> <cfoutput><li>ユーザー名 #Counter# :#ListGetAt(temp, Counter)# </cfoutput> </cfloop> </ul> |
LIST | |
リスト、またはリストを含んでいる変数です。 |
POSITION | |
正の整数、または正の整数を含んでいる変数です。要素を取得する位置を指定します。リスト内の 先頭を示す位置は 1 です。 |
DELIMITERS | |
文字列、または文字列を含んでいる変数です。リスト要素の区切り文字を指定します。デフォルト 値はカンマ (,) です。 | |
このパラメータに複数の文字が含まれている場合、それぞれの文字が出現するすべての箇所が区切 り文字として処理されます。 |