LISTLEN  
説明

リスト内の要素数を調べます。

リスト内の要素数を表す整数を返します。

 
カテゴリ

リスト関数

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

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

 
パラメータ

 
使用方法

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

次に、ListLen の処理の例を示します。

      
ListLen('a,b, c,,,d')
4
3 番めの要素は " c" です。 
ListLen('a,b, c,,,d',',')
4
4 番めの要素は "d'" です。 
ListLen('elem_1___elem_2___elem_3')
1
  
ListLen('elem*1***elem*2***elem*3')
1
  
ListLen('elem_1___elem_2___elem_3','_')
6
 

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