CFLib.org – Common Function Library Project

Description:
Prepends a string to every item in a list.

Return Values:
Returns a list.

Example:

<cfset list = "a,b,c">
<cfoutput>#listElementPrepend(list,"foo")#</cfoutput>

Parameters:

Full UDF Source:

/**
 * Prepends a string to every item in a list.
 * Version 2 by Raymond Camden
 * 
 * @param list      List to modify. (Required)
 * @param string      String to prepend. (Required)
 * @param delim      Delimiter. Defaults to a comma. (Optional)
 * @return Returns a list. 
 * @author SHUM Ting-hin (gene_shum@iclp.com.hk) 
 * @version 2, September 21, 2004 
 */
function listElementPrepend(list,string) {
    var delim = ",";
    var i = "";
    
    if(arrayLen(arguments) gte 3) delim = arguments[3];
    
    for(i=1; i lte listLen(list); i=i+1) {
        list = listSetAt(list, i, string & listGetAt(list,i));
    }
    
    return list;
}