User Guide Cancel

ListFindNoCase

 

Description

Determines the index of the first list element in which a specified value occurs.

Returns

Index of the first list element that contains value. If not found, returns zero. The search is case-insensitive.

History

ColdFusion (2018 release): Introduced named parameters.

Category

List functions

Function syntax

ListFindNoCase(list, value [, delimiters, includeEmptyFields ])
ListFindNoCase(list, value [, delimiters, includeEmptyFields ])
ListFindNoCase(list, value [, delimiters, includeEmptyFields ])

See also

ListContainsListFindLists in Data types- Developing guide in the Developing ColdFusion Applications

Parameters

Parameter

Description

includeEmptyValues

Optional. Set to yes to include empty values.

list

A list or a variable that contains one.

value

Number or string for which to search. The search is case-insensitive.

delimiters

A string or a variable that contains one. Characters that separate list elements. The default value is 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

<cfscript>
myList="Tokyo,Bangkok,bangkok,bangKok,Jakarta,Manila,Bangalore,Shanghai";
myFind=ListFindNoCase(myList,"bangkok");
WriteOutput(myFind); // Returns 2
</cfscript>
<cfscript> myList="Tokyo,Bangkok,bangkok,bangKok,Jakarta,Manila,Bangalore,Shanghai"; myFind=ListFindNoCase(myList,"bangkok"); WriteOutput(myFind); // Returns 2 </cfscript>
<cfscript>
       myList="Tokyo,Bangkok,bangkok,bangKok,Jakarta,Manila,Bangalore,Shanghai";
       myFind=ListFindNoCase(myList,"bangkok");
       WriteOutput(myFind); // Returns 2
</cfscript>

Output

2

Get help faster and easier

New user?