Listappend - MACROMEDIA COLDFUSION MX 61-CFML Reference

ListAppend

Description
Concatenates a list or element to a list.
Returns
A copy of the list
Category
List functions
Function syntax
ListAppend(list, value [, delimiters ])
See also
ListPrepend, ListInsertAt, ListGetAt, ListLast,
Parameters
Parameter
list
value
delimiters
Usage
ColdFusion inserts a delimiter character before value.
To add an element to the beginning or end of a list, Macromedia recommends that you do so
with code such as the following, rather than with the
<cfset MyValue = "another element">
<cfif listLen(myList) is 0>
<cfset myList = MyValue>
<cfelse>
<cfset myList = myList & ", " & MyValue>
</cfif>
The following table shows examples of
Statement
ListAppend('elem1,elem2', '' )
ListAppend('', 'elem1,elem2' )
ListAppend
("one___two", "three",
"___")
Example
<h3>ListAppend Example</h3>
<!--- First, query to get some values for our list elements--->
with value appended. If
,
Description
A list or a variable that contains one.
An element or a list of elements.
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 only the first
character.
Output
elem1,elem2,
elem1,elem2
"one___two_three" Inserted the first character of
, returns a copy of the list, unchanged.
delimiter = ""
ListSetAt
ListAppend
processing:
ListAppend
Comment
Appended element is empty; delimiter is last
character in list; list length is 2
List length is 2
before "three."
or functions:
ListPrepend
delimiters
ListAppend 561