User Guide
Chapter 2: ColdFusion Functions 421
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 users who wrote messages --->
<CFQUERY NAME="GetMessageUser" DATASOURCE="cfsnippets">
SELECT Username, Subject, Posted
FROM Messages
</CFQUERY>
<CFSET temp = ValueList(GetMessageUser.Username)>
<!--- loop through the list and show it with ListGetAt --->
<H3>This is a list of usernames who have posted messages
<CFOUTPUT>#ListLen(temp)#</CFOUTPUT> users.</H3>
<UL>
<CFLOOP From="1" TO="#ListLen(temp)#" INDEX="Counter">
<CFOUTPUT><LI>Username #Counter#:
#ListGetAt(temp, Counter)#</CFOUTPUT>
</CFLOOP>
</UL>
</BODY>
</HTML>