CFLib.org – Common Function Library Project

Description:
Force a value to whole quantity and restrict to a given min/max range.

Return Values:
Returns a number.

Example:

<cfoutput>
  #forceWholeQuantityRange(1.5, 2, 20)#
</cfoutput>

Parameters:

Full UDF Source:

<cfscript>
/**
 * Force a value to whole quantity and restrict to a given min/max range.
 * 
 * @param argNum 	 The number to check. (Required)
 * @param argMin 	 The minimum value of the range. (Required)
 * @param argMax 	 The maximum value of the range. (Optional)
 * @return Returns a number. 
 * @author Shawn Fairweather (&#112;&#115;&#97;&#108;&#109;&#95;&#49;&#49;&#57;&#95;&#64;&#104;&#111;&#116;&#109;&#97;&#105;&#108;&#46;&#99;&#111;&#109;) 
 * @version 1, September 27, 2004 
 */
function forceWholeQuantityRange(argNum, argMin){
	var qnty = argNum;

	if(IsNumeric(argNum)){
		qnty = int(argNum);
	} else {
		qnty = argMin;
	}

	if(argNum LT argMin){
		qnty = argMin;
	} else if((arrayLen(arguments) gt 2) and (argNum GT arguments[3])){
		qnty = arguments[3];						
	}
	return qnty;
}
</cfscript>