CFLib.org – Common Function Library Project

Description:
Returns the index in an array containing one of the given (case-insensitive) list elements or 0 if none found.

Return Values:
Returns a number.

Example:

<cfset l = "a,b,c,d">
<cfset a = ArrayNew(1)>
<cfset a[1] = "e">
<cfset a[2] = "d">
<cfset a[3] = "ab">

<cfoutput>#ArrayListCompareNoCase(a, l)#</cfoutput>

Parameters:

Full UDF Source:

<cfscript>
/**
 * Returns the index of the first item in an array that contains a list element.
 * 
 * @param arrayToSearch 	 The array to search. (Required)
 * @param listToFind 	 List that will be searched for. If any item is found, the array index is returned. (Required)
 * @param delimiter 	 List delimiter. Defaults to a comma. (Optional)
 * @return Returns a number. 
 * @author Steve Robison, Jr (&#115;&#116;&#101;&#118;&#101;&#114;&#111;&#98;&#105;&#115;&#111;&#110;&#64;&#103;&#109;&#97;&#105;&#108;&#46;&#99;&#111;&#109;) 
 * @version 1, March 28, 2005 
 */
function ArrayListCompareNoCase(arrayToSearch,listToFind){
	//a variable for looping
	var ii = 0;		// variable for looping through list
	var jj = 0;		// variable for looping through array
	var delimiter = ',';		// default delimiter
	

	// check to see if delimiters were passed
	if (ArrayLen(arguments) gt 2) delimiter = arguments[3];

	//loop through list
	for(ii = 1; ii LTE ListLen(listToFind, delimiter); ii = ii + 1) {
	//loop through the array, looking for the value
	for(jj = 1; jj LTE arrayLen(arrayToSearch); jj = jj + 1){
		//if this is the value, return the index
		if(NOT compareNoCase(arrayToSearch[jj],ListGetAt(listToFind, ii, delimiter)))
			return jj;
	}
	}
	//if we've gotten this far, it means the value was not found, so return 0
	return 0;
}
</cfscript>