ListDeleteAt

Description

Returns list with element deleted at the specified position.

Syntax

ListDeleteAt(list, position [, delimiters ])

Parameters

Parameter

Description

list
A list.

position
Positive integer that indicates the position of the element to delete. The starting position in a list is denoted by the number 1, not 0.

delimiters
Set of delimiters used in list

Parameter	Description
list	A list.
position	Positive integer that indicates the position of the element to delete. The starting position in a list is denoted by the number 1, not 0.
delimiters	Set of delimiters used in list

Usage

ColdFusion ignores empty list elements; thus, a list that is defined as "a,b,c,,,d" is treated as a four element list.

Example

<!--- This example shows ListDeleteAt --->
<html>
<head>
<title>ListDeleteAt Example</title>
</head>
<body>
<H3>ListDeleteAt 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 'CH%'
</cfquery>
<cfset temp = ValueList(GetParkInfo.ParkName)>
<cfset deleted_item = ListGetAt(temp, "3", ",")>
<cfoutput>
<P>The original list: #temp#
</cfoutput>
<!--- now, delete the third item from the list --->
<cfset temp2 = ListDeleteAt(Temp, "3", ",")>
<cfoutput>
<P>The changed list: #temp2#
<BR><I>Note that <B>#deleted_item#</B> is not longer present
at position three of the list.</I>
</cfoutput>
</body>
</html>