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