CFLib.org – ArrayFindNoCase

ArrayFindNoCase(arrayToSearch, valueToFind)

Last updated September 6, 2002

author

Nathan Dintenfass
Send Email

Version: 1 | Requires: ColdFusion 5 | Library: DataManipulationLib

Rated 3 time(s). Average Rating: 3.7

Description:
Returns the index in an array containing a given (case-insensitive) value. It is analagous to listFind(), but with arrays. See also arrayFind().

Return Values:
Returns a number.

Example:

<cfscript>
    anArray = arrayNew(1);
    anArray[1] = "Camden";
    anArray[2] = "Archibald";
    anArray[3] = "Mueller";
    anArray[4] = "Dintenfass";
</cfscript>

<cfoutput>#arrayFindNoCase(anArray,"MUELLER")#</cfoutput>

Parameters:

Name	Description	Required
arrayToSearch	The array to search.	Yes
valueToFind	The value to look for.	Yes

Full UDF Source:

	
	<cfscript>
/**
 * Like listFindNoCase(), but for arrays.
 * 
 * @param arrayToSearch      The array to search. (Required)
 * @param valueToFind      The value to look for. (Required)
 * @return Returns a number. 
 * @author Nathan Dintenfass (nathan@changemedia.com) 
 * @version 1, September 6, 2002 
 */
function ArrayFindNoCase(arrayToSearch,valueToFind){
    //a variable for looping
    var ii = 0;
    //loop through the array, looking for the value
    for(ii = 1; ii LTE arrayLen(arrayToSearch); ii = ii + 1){
        //if this is the value, return the index
        if(NOT compareNoCase(arrayToSearch[ii],valueToFind))
            return ii;
    }
    //if we've gotten this far, it means the value was not found, so return 0
    return 0;
}
</cfscript>