ArrayAppend

Appends an array index to the end of the specified array. Returns a Boolean TRUE on successful completion.

Syntax

ArrayAppend(array, value)

array

Name of the array to which you want to append an index.

value

The value you want to place into the specified array in the last index position.

Example

<!--- This example shows ArrayAppend --->
<HTML>
<HEAD>
<TITLE>ArrayAppend Example</TITLE>
</HEAD>

<BODY>
<H3>ArrayAppend Example</H3>

<CFQUERY NAME="GetEmployeeNames" DATASOURCE="HRApp">
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 and 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>

</BODY>
</HTML>