CFLib.org – ArrayConcat

ArrayConcat(a1, a2)

Last updated September 13, 2001

Download UDF

author

Craig Fisher
Send Email

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

Rated 2 time(s). Average Rating: 3.0

Description:
Take two arguments, Array1 and Array2. Concatenates Array2 to the end of Array1.

Return Values:
Returns an array.

Example:

view plain print about

<CFSCRIPT>
a1=ArrayNew(1);
a1[1]=1;
a1[2]=2;
a1[3]=3;
a1[4]=4;
a1[5]=5;
a1[6]=6;
a2=ArrayNew(1);
a2[1]="a";
a2[2]=structNew();
a2[2].cheese="fgfgfg";
a2[3]="c";
a2[4]="d";
a3=ArrayConcat(a1, a2);
</cfscript>
a1:
<CFDUMP var="#a1#">
a2:
<CFDUMP var="#a2#">
a3:
<CFDUMP var="#a3#">

<CFSCRIPT>
a1=ArrayNew(1);
a1[1]=1;
a1[2]=2;
a1[3]=3;
a1[4]=4;
a1[5]=5;
a1[6]=6;
a2=ArrayNew(1);
a2[1]="a";
a2[2]=structNew();
a2[2].cheese="fgfgfg";
a2[3]="c";
a2[4]="d";
a3=ArrayConcat(a1, a2);
</cfscript>
a1:
<CFDUMP var="#a1#">
a2:
<CFDUMP var="#a2#">
a3:
<CFDUMP var="#a3#">

Parameters:

Name	Description	Required
a1	The first array.	Yes
a2	The second array.	Yes

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>
/**
 * Concatenates two arrays.
 * 
 * @param a1 	 The first array. 
 * @param a2 	 The second array. 
 * @return Returns an array. 
 * @author Craig Fisher (&#99;&#114;&#97;&#105;&#103;&#64;&#97;&#108;&#116;&#97;&#105;&#110;&#101;&#116;&#114;&#97;&#99;&#116;&#105;&#118;&#101;&#46;&#99;&#111;&#109;) 
 * @version 1, September 13, 2001 
 */
function ArrayConcat(a1, a2){
	var i=1;
	if ((NOT IsArray(a1)) OR (NOT IsArray(a2))) {
		writeoutput("Error in <Code>ArrayConcat()</code>! Correct usage: ArrayConcat(<I>Array1</I>, <I>Array2</I>) -- Concatenates Array2 to the end of Array1");
		return 0;
	}
	for (i=1;i LTE ArrayLen(a2);i=i+1) {
		ArrayAppend(a1, Duplicate(a2[i]));
	}
	return a1;
}
</cfscript>
		<cfscript>
/**
 * Concatenates two arrays.
 * 
 * @param a1      The first array. 
 * @param a2      The second array. 
 * @return Returns an array. 
 * @author Craig Fisher (craig@altainetractive.com) 
 * @version 1, September 13, 2001 
 */
function ArrayConcat(a1, a2){
    var i=1;
    if ((NOT IsArray(a1)) OR (NOT IsArray(a2))) {
        writeoutput("Error in <Code>ArrayConcat()</code>! Correct usage: ArrayConcat(<I>Array1</I>, <I>Array2</I>) -- Concatenates Array2 to the end of Array1");
        return 0;
    }
    for (i=1;i LTE ArrayLen(a2);i=i+1) {
        ArrayAppend(a1, Duplicate(a2[i]));
    }
    return a1;
}
</cfscript>