ArrayAppend function in ColdFusion

Description

Appends an array element to an array. Concatenates arrays when the merge argument is set to true and the value argument is an array.

Returns

True, on successful completion.

Function syntax

ArrayAppend(array, value [,merge])

History

Coldfusion 10: Added the merge argument

ColdFusion MX: Changed behavior: this function can be used on XML objects.

Parameters

Parameter	Description
array	Name of an array
value	Value to add at end of array
merge	If set to true, and value parameter is an array, appends array elements individually to the source array. If false (default) the complete array is added as one element at the end, in the source array. If value is not an array this argument is ignored.

<cfscript>
       myArray=[1,2,3,4,5];
       ArrayAppend(myArray,6,"true");
       writeoutput(serializeJSON(myArray)); //adds the value 6 to myArray
</cfscript>

Output

[1,2,3,4,5,6]

ArrayAppend

Applies to

Description

Returns

Category

Function syntax

See also

History

Parameters

Example