User Guide

388 Chapter 3: ColdFusion Functions
ArrayResize
Description
Resets an array to a specified minimum number of elements. This can improve performance, if
used to size an array to its expected maximum. For more than 500 elements, use
ArrayResize
immediately after using the
ArrayNew tag.
ColdFusion arrays expand dynamically as data is added.
Returns
True, on successful completion.
Category
Array functions
Function syntax
ArrayResize(array, minimum_size)
Parameters
Example
<h3>ArrayResize Example</h3>
<!--- perform a query to get the list --->
<cfquery name = "GetCourses" datasource = "cfsnippets">
SELECT * FROM Courses
</cfquery>
<!--- make a new array --->
<cfset MyArray = ArrayNew(1)>
<!--- resize that array to the number of records
in the query --->
<cfset temp = ArrayResize(MyArray, GetCourses.RecordCount)>
<cfoutput>
The array is now #ArrayLen(MyArray)# elements, to match
the query of #GetCourses.RecordCount# records.
</cfoutput>
Parameter Description
array Name of an array
minimum_size Minimum array size