CFLib.org – Common Function Library Project

Description:
Converts a structure into a key/value pair list. Ignores complex values (nested structures, arrays, etc.).

Return Values:
Returns a string.

Example:

<cfoutput>#structValueList(CGI)#</cfoutput>

Parameters:

Full UDF Source:

/**
 * Converts a structure into a key/value pair list.
 * 
 * @param struct      Structure to list. (Required)
 * @param delimiter      Delimiter. Defaults to a comma. (Optional)
 * @return Returns a string. 
 * @author Kit Brandner (kit.brandner@serebra.com) 
 * @version 1, November 6, 2006 
 */
function structValueList(struct) {
    var delimiter = ",";
    var element = 0;
    var kvName = "";
    var kvValue = "";
    var returnList = "";
        
    if(arrayLen(arguments) gt 1) delimiter = arguments[2];
        
    if (isStruct(struct)) {
        for (; element lt listLen(structKeyList(struct, delimiter)) ; element=element+1) {
            kvName = listGetAt(structKeyList(struct, delimiter), element+1, delimiter);
            kvValue = "";
            if(isSimpleValue(struct[kvName])) kvValue = struct[kvName];
            returnList = listAppend(returnList, kvName & iif(len(trim(kvValue)) gt 0, de("=" & kvValue), de("")));
        }
    }
    
    return returnList;
}