Name

ListFind

Synopsis

                  
                  ListFind(list, value [, delimiters])

Returns the index of the first occurrence of value in the specified list. The search is case-sensitive. If no matches are found, 0 is returned. An optional delimiter can be specified if the list is delimited with a character other than the comma (the default). The following example returns the index of the first element in a list that matches saturday: 

<cfset MyList = "Monday,Tuesday,Wednesday,Thursday,Friday,Saturday,Sunday">
<cfset TheValue = "saturday">
<cfset TheIndex = ListFind(MyList, TheValue)>
   
<cfoutput>
<b>List:</b> #MyList#
<p><cfif TheIndex is 0>
  The value (#TheValue#) could not be found in the list!
<cfelse>
  The Value (#TheValue#) was found in element #TheIndex# 
  (#ListGetAt(MyList, TheIndex)#).
</cfif>
</cfoutput>

Get Programming ColdFusion MX, 2nd Edition now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.

Start your free trial