CFML Reference
ColdFusion Functions

ArrayLen

Description

Determines the number of elements in an array.

Return value

The number of elements in an array.

Category

Array functions

Syntax

ArrayLen(array) 

See also

ArrayIsEmpty

History

New in ColdFusion MX: this function can be used on child XML objects.

Parameters

Parameter	Description
array	Name of an array

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>

Copyright © 2002, Macromedia Inc. All rights reserved.

Comments