Macromedia coldfusion 4.5-cfml language reference User Manual
408
CFML Language Reference
ListAppend
Returns list with value appended behind its last element.
See also
ListPrepend
,
ListInsertAt
, and
ListSetAt
.
Syntax
ListAppend(
list, value [, delimiters ])
list
Any list.
value
Number or list being appended.
delimiters
Set of delimiters used in list.
Usage
When appending an element into a list, ColdFusion needs to insert a delimiter. If
delimiters contains more than one delimiter, ColdFusion defaults to the first delimiter
in the string, or, (comma) if delimiters was omitted.
delimiters contains more than one delimiter, ColdFusion defaults to the first delimiter
in the string, or, (comma) if delimiters was omitted.
If you intend to use list functions on strings that are delimited by the conjunction ", "
(comma-space), as is common in HTTP header strings such as the COOKIE header, we
recommend that you specify delimiters to include both comma and space because
ColdFusion Server does not skip white space. For example,
(comma-space), as is common in HTTP header strings such as the COOKIE header, we
recommend that you specify delimiters to include both comma and space because
ColdFusion Server does not skip white space. For example,
ListAppend(List, "MyCookie", "," & CHR(32))
Examples
<!--- This example shows ListAppend --->
<HTML>
<HEAD>
<TITLE>ListAppend Example</TITLE>
</HEAD>
<HTML>
<HEAD>
<TITLE>ListAppend Example</TITLE>
</HEAD>
<BODY>
<H3>ListAppend Example</H3>
<!--- First, query to get some values for our list --->
<CFQUERY NAME="GetParkInfo" DATASOURCE="cfsnippets">
SELECT PARKNAME,CITY,STATE
FROM PARKS WHERE PARKNAME LIKE ‘AL%’
</CFQUERY>
<CFSET temp = ValueList(GetParkInfo.ParkName)>
<CFOUTPUT>
<P>The original list: #temp#
</CFOUTPUT>
<!--- now, append a park name to the list --->
<CFSET temp2 = ListAppend(Temp, "ANOTHER PARK", ",")>
...
<H3>ListAppend Example</H3>
<!--- First, query to get some values for our list --->
<CFQUERY NAME="GetParkInfo" DATASOURCE="cfsnippets">
SELECT PARKNAME,CITY,STATE
FROM PARKS WHERE PARKNAME LIKE ‘AL%’
</CFQUERY>
<CFSET temp = ValueList(GetParkInfo.ParkName)>
<CFOUTPUT>
<P>The original list: #temp#
</CFOUTPUT>
<!--- now, append a park name to the list --->
<CFSET temp2 = ListAppend(Temp, "ANOTHER PARK", ",")>
...