Programming ColdFusion

Name

ArrayPrepend

Synopsis

ArrayPrepend(array, value)

Adds a value to the beginning of an array. A value of True is returned upon successful completion. The following example adds an element to the beginning of an array:

<CFSET Grades = ArrayNew(1)>
<CFSET Grades[1] = 95>
<CFSET Grades[2] = 93>
<CFSET Grades[3] = 87>
<CFSET Grades[4] = 100>
<CFSET Grades[5] = 74>

<B>Original Array:</B><BR>
<CFLOOP INDEX="Element" FROM="1" TO="#ArrayLen(Grades)#">
  <CFOUTPUT>Grade #Element#: #Grades[Element]#<BR></CFOUTPUT>
</CFLOOP>

<P>Prepend the value 80 to the array:<BR>
<CFSET ArrayPrepend(Grades, "80")>

<P><B>New Array:</B><BR>
<CFLOOP INDEX="Element" FROM="1" TO="#ArrayLen(Grades)#">
  <CFOUTPUT>Grade #Element#: #Grades[Element]#<BR></CFOUTPUT>
</CFLOOP>