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>

VALUE |

Variable or array name

NUMBER |

Dimension; function tests whether the array has exactly this dimension