CFLib.org – Common Function Library Project

Description:
Determines whether any list items begin with the strToMatch.

Return Values:
Returns a boolean.

Example:

<cfoutput>#listIsItemSimilar("this,that,the other","th")#</cfoutput>

Parameters:

Full UDF Source:

/**
 * Determines whether any list items begin with the strToMatch.
 * v2 by RCamden
 * 
 * @param listIn      List of values. (Required)
 * @param strToMatch      String to search for in the beginning of each list item. (Required)
 * @param delimeter      List delimiter. Defaults to a comma. (Optional)
 * @return Returns a boolean. 
 * @author Tony Felice (sites@breckcomm.com) 
 * @version 2, January 6, 2009 
 */
function listIsItemSimilar(listIn,strToMatch){
    var delim = ",";
    var count = 0;
    var xz = "";
    
    if(arrayLen(arguments) gt 2) delim = arguments[3];
    for(xz=1;xz<=listLen(listIn,delim);xz=xz+1){
        if(findNoCase(strToMatch,left(listGetAt(listIn,xz,delim),len(strToMatch)))) return true;                            
    }
    return false;
}