ListPrepend

Returns list with value inserted at the first position, shifting all other elements one to the right.

See also ListAppend, ListInsertAt, and ListSetAt.

Syntax

ListPrepend(list, value [, delimiters ])

list

Any list.

value

Number or list being prepended.

delimiters

Set of delimiters used in list.

Usage

When prepending an element to a list, ColdFusion needs to insert a delimiter. If delimiters contain 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.

Examples

<!--- This example shows ListPrepend --->
...
<!--- First, query to get some values for our list --->
<CFQUERY NAME="GetParkInfo" DATASOURCE="cfsnippets">
SELECT  PARKNAME,CITY,STATE
FROM  PARKS
WHERE PARKNAME LIKE `DE%'
</CFQUERY>
<CFSET temp = ValueList(GetParkInfo.ParkName)>
<CFSET first_item = ListFirst(temp)>

<CFOUTPUT>
<P>The original list: #temp#
</CFOUTPUT>
<!--- now, insert an item at position 1--->
<CFSET temp2 = ListPrepend(Temp, "my Inserted Value", ",")>
...

CFML Language Reference
Chapter 2 : ColdFusion Functions