CFLib.org – ListNew

ListNew()

Last updated January 12, 2004

author

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

Rated 1 time(s). Average Rating: 1.0

Description:
Converts the passed arguments array to a list and filters blanks. Helpful for creating lists from several values stored in different variables where some may be blank. Since it uses the arguments array as the source data for a list, there is no way to specify delimiters. To use custom delimiters use ListChangeDelims on the returned list.

Return Values:
Returns a list.

Example:

Parameters:

No arguments.

Full UDF Source:

	
	<cfscript>
/**
 * Creates a list from the passed arguments, skipping empty elements.
 * 
 * @return Returns a list. 
 * @author Samuel Neff (sam@serndesign.com) 
 * @version 1, January 12, 2004 
 */
function listNew() {
    var arr = arrayNew(1);
    var i = 1;

    for(;i lte arrayLen(arguments);i=i+1) {
        if(arguments[i] neq "") arr[arrayLen(arr)+1] = arguments[i];
    }
    
    return arrayToList(arr);
}
</cfscript>