MACROMEDIA COLFUSION MX 7 - INSTALLING AND USING COLDFUSION MX, Reference

Page: 660 / 1108

660 Chapter 3: ColdFusion Functions
IsArray
Description
Determines whether a value is an array.
Returns
True, if value is an array, or a query column object.
Category
Array functions , Decision functions
Function syntax
IsArray ( value [, number ])
See also
Array functions ; “Modifying a ColdFusion XML object” in Chapter 35, “Using XML and
WDDX,” in ColdFusion MX Developer’s Guide
History
ColdFusion MX:
•
Changed behavior: if the
value
parameter contains a reference to a query result column, this
function now returns True. For example:
isArray(MyQuery[’Column1’])
returns True. (In
earlier releases, it returns False.)
•
Changed behavior: this function can be used on XML objects.
Parameters
Usage
Use this function to determine whether a value is an array or query column. This function
evaluates a Java array object, such as a vector object, as having one dimension.
Example
<h3>IsArray Example</h3>
<!--- Make an array --->
<cfset MyNewArray = ArrayNew(1)>
<!--- set some elements --->
<cfset MyNewArray[1] = "element one">
<cfset MyNewArray[2] = "element two">
<cfset MyNewArray[3] = "element three">
<!--- is it an array? --->
<cfoutput>
<p>Is this an array? # IsArray(MyNewArray) #
<p>It has #ArrayLen(MyNewArray)# elements.
<p>Contents: #ArrayToList(MyNewArray)#
</cfoutput>
Parameter Description
value Variable or array name
number Dimension; function tests whether the array has exactly this dimension