LISTVALUECOUNT |
説明 リスト内にある指定した値の個数を数えます。この検索では大文字と小文字が区別されます。
戻り値 リスト内の value のインスタンスの数
カテゴリ リスト関数、文字列関数
関数のシンタックス
    ListValueCount(list, value [, delimiters ])
関連項目 ListValueCountNoCase、『ColdFusion MX 開発ガイド』の第3章の「ColdFusion 変数の使用」 の「リスト」
パラメータ
例
    <cfquery name = "SearchByDepartment" datasource = "cfdocexamples">
    SELECT    Department
    FROM    Employees
    </cfquery>
    <h3>ListValueCount の例</h3>
    <p>この例では、ListValueCount を使用して、ある部門の従業員数を調べます。

    <form action = "listvaluecount.cfm">
    <p>部門を選択してください。</p>
       <select name = "departmentName">
             <option value = "経理部">
                経理部
             </OPTION>
             <option value = "管理部">
                管理部
             </OPTION>
             <option value = "技術部">
                技術部
             </OPTION>
             <option value = "営業部">
                営業部
             </OPTION>
       </select>
    <input type = "Submit" name = "Submit" value = "従業員リストを検索">
    </form>

    <!--- 検索する文字列が定義されるのを待機 --->
    <cfif IsDefined("FORM.Submit") and IsDefined("FORM.departmentName")>
       <cfset myList = ValueList(SearchByDepartment.Department)>
       <cfset numberInDepartment = ListValueCount(myList, FORM.departmentName)>

       <cfif numberInDepartment is 0>
          <h3><cfoutput>#FORM.departmentName#</cfoutput> には、従業員がいません。</h3>
       <cfelseIf numberInDepartment is 1>
          <cfoutput>      <p>#FORM.departmentName# には 1 人だけ従業員がいます。
          </cfoutput>
       <cfelse>
          <cfoutput>      <p>#FORM.departmentName# には、#numberInDepartment# 人の従業員がいます。
          </cfoutput>
       </cfif>
    </cfif>

LIST |
リスト、またはリストを含んでいる変数です。

VALUE |
文字列、数字、または文字列か数字を含む変数です。検索する項目を指定します。この検索では大 文字と小文字が区別されます。

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