MACROMEDIA COLFUSION MX 7-CFML Reference page 731

ListQualify
Description
Inserts a string at the beginning and end of list elements.
Returns
A copy of the list, with qualifier before and after the specified element(s).
Category
List functions
Function syntax
ListQualify(list, qualifier [, delimiters ] [, elements ])
See also
"Lists" in Chapter 3, "Using ColdFusion Variables," in ColdFusion MX Developer's Guide
History
ColdFusion MX: Changed behavior: as the
" ; otherwise, ColdFusion throws an exception. (In earlier releases, the function ignored an
char"
invalid value, and used "
Parameters
Parameter
list
qualifier
delimiters
elements
Usage
The new list might not preserve all of the delimiters in the list.
ColdFusion ignores empty list elements; thus, the list "a,b,c,,,d" has four elements.
Example
<cfquery name = "GetEmployeeNames" datasource = "cfdocexamples">
SELECT FirstName, LastName
FROM Employees
</cfquery>
<h3>ListQualify Example</h3>
<p>This example uses ListQualify to put the full names of the
employees in the query within quotation marks.</p>
; this was inconsistent with other functions.)
all"
Description
A list or a variable that contains one.
A string or a variable that contains one. Character or string to insert before and after
the list elements specified in the
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 uses the first
character as the delimiter and ignores the remaining characters.
• all: all elements
• char: elements that are composed of alphabetic characters
parameter value, you must specify "
elements
parameter.
elements
or
all"
ListQualify 731