CFLib.org – Common Function Library Project

Description:
Removes any empty structure keys from within a structure. This is often useful when passing FORM scope variables to a component as an argumentCollection.

Return Values:
Returns a structure.

Example:

<cfset s = structNew()>
<cfset s.foo = "">
<cfset s.goo = "something">
<cfdump var="#removeEmptyStructureKeys(s)#">

Parameters:

Full UDF Source:

/**
 * Removes any empty structure keys from within a structure.
 * version 2 by Raymond Camden, added var, slimmed things down a bit.
 * 
 * @param structure      Structure to modify. (Required)
 * @return Returns a structure. 
 * @author Brian Rinaldi (brinaldi@criticaldigital.com) 
 * @version 1, April 19, 2004 
 */
function removeEmptyStructureKeys(structure) {
    var newStructure = structNew();
    var keys = structKeyList(arguments.structure);
    var name = "";
    var i = 1;
    for (;i lte listLen(keys);i=i+1) {
        name = listGetAt(keys,i);
        if (not isSimpleValue(arguments.structure[name])) {
            newStructure[name] = arguments.structure[name];
        }
        else if (arguments.structure[name] neq "") {
            newStructure[name] = arguments.structure[name];
        }
    }
    return newStructure;
}