ListMap

Last updated on 27 Des 2022 | Also applies to ColdFusion

Description

Iterates over every entry of the list and calls the closure function to work on the item of the list. The returned value will be set at the same index in a new list and the new list will be returned.

Returns

List

Syntax

ListMap(list, callback [,delimiter, includeEmptyFields])

History

ColdFusion (2018 release): Introduced named parameters.

ColdFusion 11: Added this function.

Parameters

Parameter	Req/Opt	Default	Description
list	Required		The input list.
callback	Required		Closure or a function reference that will be called for each iteration. The arguments passed to the callback are item: value index: current index for the iteration list: reference of the original list delimiter: the list delimiter includeEmptyFields: include empty values.
delimiter	Optional	comma (,)	The list delimiter. The type is string .
includeEmptyFields	Optional	false	Include empty values. The type is boolean.

Example

<cfscript>
       myList="Tokyo,Bangkok,Jakarta,Manila,Bangalore,Shanghai";
       closure=function(item){ 
             return reverse(item); // Reverses each list item
             }
       myMap=ListMap(myList,closure);
       WriteOutput(myMap);
</cfscript>

Output

oykoT,kokgnaB,atrakaJ,alinaM,erolagnaB,iahgnahS