Whatever message this page gives is out now! Go check it out!
ListDeleteAt
Last update:
May 18, 2026
Description
Deletes an element from a list.
Returns
A copy of the list, without the specified element.
Category
Function syntax
ListDeleteAt(list, position [, delimiters ])
ListDeleteAt(list, position [, delimiters, includeEmptyValues ])See also
ListGetAt, ListSetAt, ListLen; Lists in Data types- Developing guide in the Developing ColdFusion Applications
Parameters
Parameter | Description |
list | A list or a variable that contains one. |
position | A positive integer or a variable that contains one. Position at which to delete element. The first list position is 1. |
delimiters | (Default: comma) A string or a variable that contains one. Characters that separate list elements. The default value is comma. If this parameter contains more than one character, ColdFusion processes each occurrence of each character as a delimiter. |
includeEmptyValues | (Default: True) If includeEmptyValues is set to false, the list will contain only nonempty elements and the element would be deleted at the specified position. |
Usage
To use this and other functions with the default delimiter (comma), you can code as follows:
<cfset temp2 = ListDeleteAt(temp, "3")>To specify another delimiter, you code as follows:
<cfset temp2 = ListDeleteAt(temp, "3", ";")>ColdFusion ignores empty list elements; thus, the list "a,b,c,,,d" has four elements.
Example
<cfscript>
myList="Tokyo,Bangkok,Jakarta,Manila,Bangalore,Shanghai";
WriteOutput(ListDeleteAt(myList,3) & " * "); //Deletes Jakarta at index 3
mySecondList="London,Paris|Sau Paulo,Santiago,Buenos Aires|New York,Montreal,Seattle|Tokyo,Shanghai";
WriteOutput(ListDeleteAt(mySecondList,3,"|")); //Deletes index 3 using custom delimiter
</cfscript>Output
Tokyo,Bangkok,Manila,Bangalore,Shanghai * London,Paris|Sau Paulo,Santiago,Buenos Aires|Tokyo,Shanghai
We're glad. Tell us how this page helped.
We're sorry. Can you tell us what didn't work for you?
Share additional feedback to help us improve.
0/255
|
