User Guide

590 Chapter 3: ColdFusion Functions
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
Parameters
Example
<cfquery name = "SearchByDepartment" datasource = "cfsnippets">
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">
Sales
</OPTION>
</select>
<input type = "Submit" name = "Submit" value = "Search Employee List">
</form>
<!--- wait to have a string for searching defined --->
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.
Default: comma.
If this parameter contains more than one character, ColdFusion processes each
occurrence of each character as a delimiter.