ListInsertAt

Returns list with value inserted at the specified position.

See also ListDeleteAt, ListAppend, ListPrepend, and ListSetAt.

Syntax

ListInsertAt(list, position, value [, delimiters ])

list

Any list.

position

Position where the value is being inserted. The first position in a list is denoted by the number 1, not 0.

value

Number or list being inserted.

delimiters

Set of delimiters used in list.

Usage

When inserting elements into 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 ListInsertAt --->
<!--- First, query to get some values for our list. --->
<HTML>
<CFQUERY NAME="GetMessages" DATASOURCE="CFExpress">
SELECT Subject
FROM  Messages
</CFQUERY>

<CFSET temp=ValueList(GetMessages.Subject)>

<CFOUTPUT>
<P>The original list: #temp#
</CFOUTPUT>
<!--- Now, insert an item at position three. --->
<CFSET temp2=ListInsertAt(Temp, "3", "<B>my Inserted Value</B>", ",")>
<CFOUTPUT>
<P>The new list: #temp2#
</CFOUTPUT>
</HTML>
...