ListContainsNoCase

Description

Determines the index of the first list element that contains a specified substring.

Return value

Index of the first list element that contains substring, regardless of case. If not found, returns zero.

Syntax

ListContainsNoCase(list, substring [, delimiters ])

Parameters

Parameter Description

list
A list or a variable that contains one.

substring
A string or a variable that contains one. The search is case-insensitive.

delimiters
A string or a variable that contains one. Character(s) that separate list elements. Default: comma.
If this parameter contains more than one character, ColdFusion processes each occurrence of each character as a delimiter.

Parameter	Description
list	A list or a variable that contains one.
substring	A string or a variable that contains one. The search is case-insensitive.
delimiters	A string or a variable that contains one. Character(s) that separate list elements. Default: comma. If this parameter contains more than one character, ColdFusion processes each occurrence of each character as a delimiter.

Usage

ColdFusion ignores empty list elements; thus, the list "a,b,c,,,d" has four elements.

Example

<h3>ListContainsNoCase Example</h3>

<cfif IsDefined("FORM.letter")>
  <!--- First, query to get some values for our list elements--->
  <cfquery name = "GetParkInfo" datasource = "cfsnippets">
  SELECT PARKNAME,CITY,STATE
  FROM PARKS
  WHERE PARKNAME LIKE '#FORM.letter#%'
  </cfquery>
  <cfset tempList = ValueList(GetParkInfo.City)>
  <cfif ListContainsNoCase(tempList, FORM.yourCity) is not 0 OR
   FORM.yourCity is "">
  <p><cfif FORM.yourCity is "">The list of parks for the letter
   <cfoutput>#FORM.Letter#</cfoutput>