ArrayNew

Description

Creates an array of 1-3 dimensions. Index array elements with square brackets: [ ].

ColdFusion arrays expand dynamically as data is added.

Returns

An array

Category

Array functions

Function syntax

ArrayNew(dimension)

Parameters

Parameter Description

dimension

Number of dimensions in new array:

1, 2, or 3

Example

<h3>ArrayNew Example</h3>
<!--- Make an array --->
<cfset MyNewArray = ArrayNew(1)>
<!--- ArrayToList does not function properly if the Array is not initialized with
ArraySet ---> <cfset temp = ArraySet(MyNewArray, 1,6, "")> <!--- set some elements ---> <cfset MyNewArray[1] = "Sample Value"> <cfset MyNewArray[3] = "43"> <cfset MyNewArray[6] = "Another Value"> <!--- is it an array? ---> <cfoutput> <p>Is this an array? #IsArray(MyNewArray)# <p>It has #ArrayLen(MyNewArray)# elements. <p>Contents: #ArrayToList(MyNewArray)# <!--- the array has expanded dynamically to six elements with the use of ArraySet,
even though we only set three values ---> </cfoutput>

ColdFusion 9 | ColdFusion 8 | ColdFusion MX 7 | ColdFusion MX 6.1 | ColdFusion MX | Forums | Developer Center | KnowledgeBase | Bug Reporting

Version 7

 

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

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