Table of Contents
Advertisement
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 ])
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 = "cfsnippets">
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>
<cfset myArray = ArrayNew(1)>
<!--- loop through query; append these names successively to the last element -
-->
<cfloop query = "GetEmployeeNames">
<cfset temp = ArrayAppend(myArray, "#FirstName# #LastName#")>
</cfloop>
582
Chapter 3: ColdFusion Functions
; 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.
Default: 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
attribute.
elements
or
all"
Advertisement
Table of Contents
