ARRAYAPPEND | |
Description
Appends an array element to an array. |
|
Returns
True, on successful completion. |
|
Category
Array functions |
|
Function syntaxArrayAppend(array, value) |
|
See also
ArrayPrepend; "Adding elements to an array" in Chapter 5, "Using Arrays and Structures," in ColdFusion MX Developer's Guide |
|
History
ColdFusion MX: Changed behavior: this function can be used on XML objects. |
|
Parameters
|
|
Example<h3>ArrayAppend Example</h3> <cfquery name = "GetEmployeeNames" datasource = "cfdocexamples"> 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> |
ARRAY | |
VALUE | |