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.

Function syntax

ArrayResize(array, minimum_size)

Parameters

Parameter	Description
array	Name of an array
minimum_size	Minimum array size

Example

<h3>ArrayResize Example</h3>
<!--- perform a query to get the list --->
<cfquery name = "GetCourses" datasource = "cfdocexamples">
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>

Version 7

Comments

No screen name said on Jul 5, 2005 at 1:38 PM :

arrayResize has trouble reducing the size of an array. It cant be used to remove the tail elements of the array. Im not sure if it can be used on an array with any data in it, or if will only remove elements which are empty.

RSS feed | Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/coldfusion/7/htmldocs/00000392.htm