CFLib.org – CreateOrderedList

CreateOrderedList(st, end [, step] [, delim])

Last updated September 28, 2006

author

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

Rated 1 time(s). Average Rating: 4.0

Description:
Pass in Start and End numbers (with options for delim and step increment) and this UDF will generate an Ascending (or descending), ordered delimited list in your step increment.

Return Values:
Returns a string.

Example:

view plain print about

<cfoutput>
Basic: #CreateOrderedList(1,10)#<br>
Step Down: #createOrderedList(0,-25,5,"|")#
</cfoutput>

<cfoutput>
Basic: #CreateOrderedList(1,10)#<br>
Step Down: #createOrderedList(0,-25,5,"|")#
</cfoutput>

Parameters:

Name	Description	Required
st	Start number.	Yes
end	End number.	Yes
step	Step value. Defaults to 1.	No
delim	List delimiter. Defaults to a comma.	No

Full UDF Source:

	
	
			
			
			
				
				view plain
				
				
				copy to clipboard
				
				
				
				
				print
				
				
				about
				ColdFISH is developed by Jason Delmore.  Source code and license information available at coldfish.riaforge.org.  Version 3.1.1
				
			<cfscript>
/**
 * Used to create an Ordered Numeric List
 * v2 mods by Raymond Camden
 * 
 * @param st 	 Start number. (Required)
 * @param end 	 End number. (Required)
 * @param step 	 Step value. Defaults to 1. (Optional)
 * @param delim 	 List delimiter. Defaults to a comma. (Optional)
 * @return Returns a string. 
 * @author Mike Gillespie (&#109;&#105;&#107;&#101;&#64;&#115;&#116;&#114;&#105;&#107;&#105;&#110;&#103;&#46;&#99;&#111;&#109;) 
 * @version 1, September 28, 2006 
 */
function createOrderedList(st,end) {
	var theList="";
	var delim=",";
	var step=1;

	// 3rd argument sets the step increment
	if(arraylen(arguments) gte 3) step=arguments[3];

	//4th argument sets the delim
	if(arraylen(arguments) eq 4) delim=arguments[4];

	if(st gte end) for(i = st;i gte end;i=i-step) theList=listappend(theList,i,delim);		
	else for(i = st;i lte end;i=i+step) theList=listappend(theList,i,delim);		

	return theList;
}
</cfscript>
		<cfscript>
/**
 * Used to create an Ordered Numeric List
 * v2 mods by Raymond Camden
 * 
 * @param st      Start number. (Required)
 * @param end      End number. (Required)
 * @param step      Step value. Defaults to 1. (Optional)
 * @param delim      List delimiter. Defaults to a comma. (Optional)
 * @return Returns a string. 
 * @author Mike Gillespie (mike@striking.com) 
 * @version 1, September 28, 2006 
 */
function createOrderedList(st,end) {
    var theList="";
    var delim=",";
    var step=1;

    // 3rd argument sets the step increment
    if(arraylen(arguments) gte 3) step=arguments[3];

    //4th argument sets the delim
    if(arraylen(arguments) eq 4) delim=arguments[4];

    if(st gte end) for(i = st;i gte end;i=i-step) theList=listappend(theList,i,delim);        
    else for(i = st;i lte end;i=i+step) theList=listappend(theList,i,delim);        

    return theList;
}
</cfscript>