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
IsArray(value [, number ])
See also
Array functions; Modifying a ColdFusion XML object in the Developing ColdFusion Applications
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
Parameter |
Description |
|---|---|
value |
Variable or array name |
number |
Dimension; function tests whether the array has exactly this dimension |
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>
Twitter™ and Facebook posts are not covered under the terms of Creative Commons.