User Guide

ArrayLen 383
ArrayLen
Description
Determines the number of elements in an array.
Returns
The number of elements in an array.
Category
Array functions
Function syntax
ArrayLen(array)
See also
ArrayIsEmpty
History
ColdFusion MX: Changed behavior: this function can be used on child XML objects.
Parameters
Example
<h3>ArrayLen Example</h3>
<cfquery name = "GetEmployeeNames" datasource = "cfsnippets">
SELECT FirstName, LastName FROM Employees
</cfquery>
<!--- create an array --->
<cfset myArray = ArrayNew(1)>
<!--- set element one to show where we are --->
<cfset myArray[1] = "Test Value">
<!--- loop through the query and append these names
successively to the last element --->
<cfloop query = "GetEmployeeNames">
<cfset temp = ArrayAppend(myArray, "#FirstName# #LastName#")>
</cfloop>
<!--- show the resulting array as a list --->
<cfset myList = ArrayToList(myArray, ",")>
<!--- output the array as a list --->
<cfoutput>
<p>The contents of the array are as follows:
<p>#myList#
<p>This array has #ArrayLen(MyArray)# elements.
</cfoutput>
Parameter Description
array Name of an array