Chapter 2: ColdFusion Functions
267
ArrayPrepend
Adds an array element to the beginning of the specified array. Returns a Boolean TRUE
on successful completion.
See also
ArrayAppend
.
Syntax
ArrayPrepend
(
array, value)
array
Name of the array to which you want to prepend data.
value
The value you want to add to the beginning of the specified array.
Examples
<!--- This example shows ArrayPrepend --->
<HTML>
<HEAD>
<TITLE>ArrayPrepend Example</TITLE>
</HEAD>
<BODY>
<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 the query and append these names
successively before the last element (this list will
reverse 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>
</BODY>
</HTML>
Summary of Contents for COLDFUSION 4.5-CFML LANGUAGE
Page 1: ...Allaire Corporation CFML Language Reference ColdFusion 4 5...
Page 207: ...Chapter 1 ColdFusion Tags 183 CFCATCH CFTRY BODY HTML...
Page 224: ...200 CFMLLanguageReference CFOUTPUT P Text within CFOUTPUT is always shown CFOUTPUT BODY HTML...
Page 336: ...312 CFMLLanguageReference CFIF BODY HTML...
Page 404: ...380 CFMLLanguageReference DE It is morning CFOUTPUT P BODY HTML...
Page 413: ...Chapter 2 ColdFusion Functions 389 Customer BalanceDue BR CFOUTPUT CFIF BODY HTML...
Page 483: ...Chapter 2 ColdFusion Functions 459 CFOUTPUT CFLOOP BODY HTML...
Page 584: ...560 CFMLLanguageReference...
Page 594: ...570 CFMLLanguageReference...
