ArrayAppend

Description

Appends an array element to an array.

Return value

True, on successful completion.

Syntax

ArrayAppend(array, value)

History

New in ColdFusion MX: this function can be used on XML objects.

Parameters

Parameter Description

array
Name of an array

value
Value to add at end of array

Parameter	Description
array	Name of an array
value	Value to add at end of array

Example

<h3>ArrayAppend Example</h3>
<cfquery name = "GetEmployeeNames" datasource = "cfsnippets">
SELECT FirstName, LastName FROM Employees
</cfquery>
<!--- create an array --->
<cfset myArray = ArrayNew(1)>
<!--- set element one to show where we are --->
<cfset myArray[1] = "Test Value">
<!--- loop through the query; append these names successively to the last 
element --->
<cfloop query = "GetEmployeeNames">
  <cfoutput>#ArrayAppend(myArray, "#FirstName# #LastName#")#
  </cfoutput>, Array was appended<br>
</cfloop>
<!--- show the resulting array as a list --->
<cfset myList = ArrayToList(myArray, ",")>
<!--- output the array as a list --->
<cfoutput>
  <p>The contents of the array are as follows:
  <p>#myList#
</cfoutput>