CFLib.org – Common Function Library Project

Description:
This UDF appends allows the user to append a key-value set to a two-dimensional array. The code is easily modifiable for more than two dimensions.

Return Values:
Returns the array.

Example:

<cfset aSideNav = ArrayNew(2)>
<cfset aSideNav[1][1] = "New Project">
<cfset aSideNav[1][2] = "project.cfm?ID=0">

<cfset aSideNav = arrayAppend2D(aSideNav, "Bid Results", "bidresults.cfm")>

Parameters:

Full UDF Source:

<cfscript>
/**
 * Appends two values to a 2D array.
 * 
 * @param aName 	 The array. (Required)
 * @param value1 	 First value. (Required)
 * @param value2 	 Second value. (Required)
 * @return Returns the array. 
 * @author Minh Lee Goon (&#99;&#111;&#110;&#116;&#97;&#99;&#116;&#64;&#100;&#105;&#103;&#101;&#114;&#97;&#116;&#105;&#100;&#101;&#115;&#105;&#103;&#110;&#115;&#116;&#117;&#100;&#105;&#111;&#115;&#46;&#99;&#111;&#109;) 
 * @version 1, March 21, 2006 
 */
function arrayAppend2D(aName, value1, value2) {
	var theLen = arrayLen(aName);
		
	aName[theLen+1][1] = value1;
	aName[theLen+1][2] = value2;
		
	return aName;
}
</cfscript>