LISTFIND  
説明

指定された値が出現する最初のリスト要素のインデックスを調べます。大文字と小文字は区別されます。

 
戻り値

value を含んでいる最初のリスト要素のインデックス。大文字と小文字は区別されます。検出されなかった場合は 0 が返されます。この検索では大文字と小文字が区別されます。

 
カテゴリ

リスト関数

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

ListContains、ListFindNoCase、『ColdFusion MX 開発ガイド』の第3章の「ColdFusion 変数の使用」 の「リスト」

 
パラメータ

 
使用方法

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

 
<!--- 部分文字列がリスト内に存在するかどうかを調べるには、ListFind と ListFindNoCase を使用します ---> 
<form action="./listfind.cfm" method="POST"> 
   <p>Leary の姓の大文字と小文字を変えてみてください。 
   <br><input type="Text" size="25" name="myString" value="Leary">
   <p>検索タイプを選択してください。 
      <select name="type"> 
         <option value="ListFind" selected>大文字と小文字を区別する 
         <option value="ListFindNoCase">大文字と小文字を区別しない 
      </select> 
   <input type="Submit" name="" value="従業員リストを検索"> 
</form> 

<!--- 検索する文字列が定義されるのを待機 ---> 
<cfif IsDefined("form.myString") and IsDefined("form.type")> 

<cfquery name="SearchEmpLastName" datasource="cfdocexamples"> 
   SELECT  FirstName, RTrim(LastName) AS LName, Phone, Department
   FROM Employees
</cfquery> 

<cfset myList = ValueList(SearchEmpLastName.LName)> 
<!--- この検索で大文字と小文字を区別する場合としない場合 ---> 
<cfif form.type is "ListFind"> 
   <cfset temp = ListFind(myList, form.myString)>
      <cfif temp is 0> 
         <h3>姓が完全に一致する従業員は検索されませんでした。</h3>
      <cfelse> 
         <cfoutput> 
         <p>Employee #ListGetAt(ValueList(SearchEmpLastName.FirstName), temp)# 
         #ListGetAt(ValueList(SearchEmpLastName.LName), temp)#, of the
         #ListGetAt(ValueList(SearchEmpLastName.Department), temp)# Department,
         can be reached at #ListGetAt(ValueList(SearchEmpLastName.Phone),
         temp)#.
         <p>これが、大文字と小文字を区別して姓を検索した結果
         見つかった最初の従業員です。 
         </cfoutput> 
      </cfif> 
      <cfelse> 
         <cfset temp = ListFindNoCase(myList, form.myString)>
         <cfif temp is 0> 
            <h3>姓が完全に一致する従業員は検索されませんでした。</h3>
         <cfelse> 
            <cfoutput> 
            <p>Employee #ListGetAt(ValueList(SearchEmpLastName.FirstName), temp)# 
            #ListGetAt(ValueList(SearchEmpLastName.LName), temp)#, of the
            #ListGetAt(ValueList(SearchEmpLastName.Department), temp)#
            Department, can be reached at
            #ListGetAt(ValueList(SearchEmpLastName.Phone), temp)#. 
            <p>これが、大文字と小文字を区別しないで姓を検索した結果
            見つかった最初の従業員です。 
         </cfoutput> 
      </cfif> 
   </cfif> 
</cfif> 
LIST  
リスト、またはリストを含んでいる変数です。
VALUE  
文字列、数字、あるいは、文字列または数字を含んでいる変数です。検索する項目を指定します。 この検索では大文字と小文字が区別されます。
DELIMITERS  
文字列、または文字列を含んでいる変数です。リスト要素の区切り文字を指定します。デフォルト 値はカンマ (,) です。
このパラメータに複数の文字が含まれている場合、それぞれの文字が出現するすべての箇所が区切 り文字として処理されます。