User Guide

ListValueCount 739
ListValueCount
Description
Counts instances of a specified value in a list. The search is case-sensitive.
Returns
The number of instances of value in the list.
Category
List functions, String functions
Function syntax
ListValueCount(list, value [, delimiters ])
See also
ListValueCountNoCase
; “Lists” in Chapter 3, “Using ColdFusion Variables,” in ColdFusion MX
Developer’s Guide
Parameters
Example
<cfquery name = "SearchByDepartment" datasource = "cfdocexamples">
SELECT Department
FROM Employees
</cfquery>
<h3>ListValueCount Example</h3>
<p>This example uses ListValueCount to count employees in a department.
<form action = "listvaluecount.cfm">
<p>Select a department:</p>
<select name = "departmentName">
<option value = "Accounting">
Accounting
</OPTION>
<option value = "Administration">
Administration
</OPTION>
<option value = "Engineering">
Engineering
</OPTION>
<option value = "Sales">
Parameter Description
list A list or a variable that contains one.
value String or number, or a variable that contains one. Item for which to search. The
search is case-sensitive.
delimiters A string or a variable that contains one. Character(s) that separate list elements.
The default value is comma.
If this parameter contains more than one character, ColdFusion processes each
occurrence of each character as a delimiter.