CFLib.org – Common Function Library Project

Description:
Useful if you need to clean up a form for whatever reason before using the cfinsert or cfupdate tag. Takes a comma-delimited list of form field names as its only argument.

Return Values:
Returns nothing.

Example:

<cfset form.field1 = "foo">
<cfset form.field2 = "goo">
<cfset form.field3 = "zoo">
<cfset form.fieldnames="field1,field2,field3">
<cfdump var="#form#">
<cfset theFields = "field1,field2">
<cfset deleteFormFields(theFields)>
<cfdump var="#form#">

Parameters:

Full UDF Source:

<cfscript>
/**
 * Removes specified fields from a form structure.
 * 
 * @param fieldList 	 List of fields to return. (Required)
 * @return Returns nothing. 
 * @author Tom Young (&#116;&#111;&#109;&#64;&#116;&#104;&#101;&#110;&#101;&#119;&#109;&#101;&#100;&#105;&#97;&#103;&#114;&#111;&#117;&#112;&#46;&#99;&#111;&#109;) 
 * @version 1, June 12, 2003 
 */
function deleteFormFields(fieldList) {
	var listIndex = 1;
	var i = 1;
	fieldList = ListToArray(fieldList);
	for(i = 1; i lte ArrayLen(fieldList); i = i + 1) {
		StructDelete(form, fieldList[i]);
		listIndex = ListFindNoCase(form.fieldnames, fieldList[i]);
		form.fieldnames = ListDeleteAt(form.fieldnames, listIndex);
	}
}
</cfscript>