Returns the index of the first occurrence of a value within a list. Returns 0 if no value was found. The search is case-insensitive.
See also ListContains and ListFind.
ListFindNoCase(list, value [, delimiters ])
List being searched.
Number or string being sought among elements of list.
Set of delimiters used in list.
<!--- This example uses ListFind and ListFindNoCase to see if a substring exists in a list ---> <HTML> <HEAD> <TITLE>ListFind Example</TITLE> </HEAD> <BASEFONT FACE="Arial, Helvetica" SIZE=2> <BODY bgcolor="#FFFFD5"> <H3>ListFind Example</H3> <P>This example uses ListFind or ListFindNoCase to see if an exact string exists in a list <FORM ACTION="listfind.cfm" METHOD="POST"> <P>Try changing the case in Leary's last name: <BR><INPUT TYPE="Text" size=25 NAME="myString" VALUE="Hove"> <P>Pick a search type: <SELECT NAME="type"> <OPTION VALUE="ListFind" SELECTED>Case-Sensitive <OPTION VALUE="ListFindNoCase">Case-Insensitive </SELECT> <INPUT TYPE="Submit" NAME="" VALUE="Search Employee List"> </FORM> <!--- wait to have a string for searching defined ---> <CFIF IsDefined("form.myString") and IsDefined("form.type")> <CFQUERY Name="SearchEmpLastName" DATASOURCE="HRAPP"> SELECT FirstName, RTrim(LastName) AS LName, StartDate FROM Employees </CFQUERY> <CFSET myList = ValueList(SearchEmpLastName.LName)> <!--- Is this case-sensitive or case-insensitive searching ---> <CFIF form.type is "ListFind"> <CFSET temp = ListFind(myList, form.myString)> <CFIF temp is 0> <H3>An employee with that exact last name was not found</H3> <CFELSE> <CFOUTPUT> <P>Employee #ListGetAt(ValueList(SearchEmpLastName.FirstName), temp)# #ListGetAt(ValueList(SearchEmpLastName.LName), temp)# started #DateFormat(ListGetAt(ValueList(SearchEmpLastName.StartDate), temp))#. <P>This was the first employee found under this case-sensitive last name search. </CFOUTPUT> </CFIF> <CFELSE> <CFSET temp = ListFindNoCase(myList, form.myString)> <CFIF temp is 0> <H3>An employee with that exact last name was not found</H3> <CFELSE> <CFOUTPUT> <P>Employee #ListGetAt(ValueList(SearchEmpLastName.FirstName), temp)# #ListGetAt(ValueList(SearchEmpLastName.LName), temp)#, started on #DateFormat(ListGetAt(ValueList(SearchEmpLastName.StartDate), temp))#. <P>This was the first employee found under this case-insensitive last name search. </CFOUTPUT> </CFIF> </CFIF> </CFIF> </BODY> </HTML>