ListLen

Returns the number of elements in the list.

See also ListAppend, ListDeleteAt, ListInsertAt, and ListPrepend.

Syntax

ListLen(list [, delimiters ])
list

Any list.

delimiters

Set of delimiters used in list.

Examples

<!--- This example shows ListGetAt and ListLen --->
<HTML>
<HEAD>
<TITLE>ListLen Example</TITLE>
</HEAD>

<BODY>
<H3>ListLen Example</H3>

<!--- Find a list of employees in HR --->
<CFQUERY NAME="GetEmployees" DATASOURCE="HRApp">
SELECT    LastName, FirstName
FROM Employees
Where Department_ID = 1
</CFQUERY>

<CFSET last=ValueList(GetEmployees.LastName)>
<CFSET first=ValueList(GetEmployees.FirstName)>

<!--- loop through the list and show it with ListGetAt --->
<H3>There are <CFOUTPUT>#ListLen(last)#</CFOUTPUT> people in the Training 
Department. They are
</H3>
<UL>
<CFLOOP FROM="1" TO="#ListLen(first)#" INDEX="Counter">
    <CFOUTPUT><LI>#Counter#: #ListGetAt(first, Counter)#
     #ListGetAt(last, Counter)#
    </CFOUTPUT>
</CFLOOP>
</UL>

</BODY>