CFLib.org – Common Function Library Project

Description:
Iterates over a list, calling a callback for each element. Returns an ARRAY of the results of the callback calls. The callback receives the arguments passed to the listEach(), plus index, element and length.

Return Values:
An array containing the returned values from each callback call

Example:

numbers = "tahi|rua|toru|wha";

function _ucase(){
    return ucase(element);
}

upperCasedNumbers = listEach(numbers, _ucase, "|");
writeOutput(serializeJson(upperCasedNumbers));

Parameters:

Full UDF Source:

/**
 * UDF to loop over a list
 * v1.0 by Adam Cameron
 * 
 * @param list      A list to iterate over (Required)
 * @param callback      A callback to call for each element of the list (Required)
 * @param delimiters      The delimiters the list uses. Defaults to a comma (Optional)
 * @return An array containing the returned values from each callback call 
 * @author Adam Cameron (dac.cfml@gmail.com) 
 * @version 1.0, October 17, 2013 
 */
public array function listEach(required string list, required function callback, string delimiters=","){
    var arr = listToArray(list, delimiters);
    var arrLen = arrayLen(arr);
    var result = [];
    for (var index=1; index <= arrLen; index++){
        arrayAppend(result, callBack(argumentCollection=arguments, index=index, element=arr[index], length=arrLen));
    }
    return result;
}