ArrayPrepend  
Description
Inserts an array element at the beginning of an array.
 
Returns
True, on successful completion.
 
Category
Array functions
 
Function syntax
ArrayPrepend(array, value)
 
See also
ArrayAppend
 
Parameters
 
Parameter      Description
array Name of an array
value Value to insert at beginning of array
 
Example
<h3>ArrayPrepend 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 query. Append names successively before last element (list
reverses itself from the standard queried output, as it keeps 
prepending the array entry) --->
<cfloop query = "GetEmployeeNames">
   <cfoutput>#ArrayPrepend(myArray, "#FirstName# #LastName#")#
   </cfoutput>, Array was prepended<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  
Name of an array
value  
Value to insert at beginning of array