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>

Variable or array name

VALUE  

Dimension; function tests whether the array has exactly this dimension

NUMBER