arrayIsEmpty
Description
Determines whether an array is empty of data elements.
Categories
Related
History
ColdFusion
MX: Changed behavior: this function can be used on XML objects.
Syntax
ArrayIsEmpty(array)
Attributes
| Attribute | Description | Required | Default |
|---|---|---|---|
| array | Name of an array |
Returns
True,
if the array is empty; False, otherwise.
Usage
You can test whether an element of a higher level dimension of a multidimensional array is empty by specifying the element in the ArrayIsEmpty function. To test whether the first row of the two-dimensional array MyArray is empty, use the following function:
ArrayIsEmpty(MyArray2[1])
ArrayIsEmpty(MyArray2[1])
Example
<h3>ArrayIsEmpty Example</h3> <!--- Create a new array. ---> <cfset MyArray = ArrayNew(1)> <!--- Populate an element or two. ---> <cfset MyArray[1] = "Test"> <cfset MyArray[2] = "Other Test"> <!--- Output the contents of the array. ---> Your array contents are: <cfoutput>#ArrayToList(MyArray)#</cfoutput> <!--- Check to see if the array is empty. ---> Is the array empty?: <cfoutput>#ArrayIsEmpty(MyArray)#</cfoutput> Now, clear the array: <!--- Now clear the array. ---> <cfset Temp = ArrayClear(MyArray)> <!--- Check to see if the array is empty. ---> Is the array empty?: <cfoutput>#ArrayIsEmpty(MyArray)#</cfoutput>