Whatever message this page gives is out now! Go check it out!
ArrayEach
Last update:
May 18, 2026
Note:
You can also set the maximum thread count in ColdFusion Administrator. Click Server Settings > Settings and specify the number of threads in Default Maximum Thread Count For Parallel Functions .
Description
Loops over an array.
Returns
Nothing
Category
Syntax
arrayEach(array, function(item, [index, [array]]){} [, parallel] [, maxThreadCount])
See also
History
ColdFusion (2021 release): Introduced the following parameters:
- parallel
- maxThreadCount
ColdFusion (2018 release): Introduced named parameters.
ColdFusion 11: Passing array index to callback functions.
ColdFusion 10: Added this function.
Parameters
Parameter | Description |
array | Name of the array. |
callback | Closure function executed for each element in the array. |
parallel | True if you want to enable parallel programming. |
maxThreadCount | The number of threads the function can execute. The number of threads must be between 1-50. If the value exceeds 50, there is an exception. |
Basic example using the callback function
<cfscript>
myCities=["London","New York","Paris","Tokyo","Barcelona"];
// Create a function that takes city as an argument and prints the name of the cities as output
// with delimiter as space
ArrayEach(myCities,function(city){
WriteOutput(city & " ");
}
);
</cfscript>Output
London New York Paris Tokyo Barcelona
Passing array index to callback functions in ArrayEach
ColdFusion 10 supported passing objects in a callback function. In ColdFusion 11, you could pass the index of an array to the callback function as shown below:
<cfscript>
cityArray = ["San Jose","New york","Boston", "Las Vegas"];
function printArrayCity(city, index)
{
writeOutput("<br>" & city & " is at index " & index);
}
ArrayEach(cityArray ,printArrayCity);
</cfscript>Output
San Jose is at index 1New york is at index 2Boston is at index 3Las Vegas is at index 4
Passing array to the closure function
Also, the original array can also be passed to the closure function. So the following code is also valid:
function printArrayCity(city, index, cityArray)
{
}
...For example,
<cfapplication passarraybyreference="true">
<cfscript>
cityArray=["London","New York","Paris","Tokyo","Barcelona"];
function printArray(city,index,cityArray)
{
cityArray[index] = city & " is visited.";
}
WriteOutput("The original array is:");
WriteDump(cityArray);
ArrayEach(cityArray,printArray);
WriteOutput("The new array is:");
WriteDump(cityArray);
</cfscript>Output
Using parallelization
<cfscript>
for(i=1;i<=1001;i++){
arr[i] = RepeatString("LoremIpsum",i)
if (i == 264)
arr[i] = 'wwwwxxxx'
}
function callback(item,index){
item = item & "ss";
if (index == 264)
writeoutput(item & "<br>");
return item;
}
writeoutput("output after no parallel for arr[264]:")
arr.each(callback,false)
writeoutput("output with 5 parallel threads for arr[264]:")
arrayeach(arr,callback,true,5)
writeoutput("output with 10 parallel threads for arr[264]:" )
arr.each(callback,true,10)
writeoutput("output with 20 parallel threads for arr[264]:" )
arrayeach(array=arr,callback=callback,parallel=true,maxthreadcount=20)
writeoutput("output with 40 parallel threads for arr[264]:" )
arrayeach(array=arr,callback=callback,parallel=true,maxthreadcount=40)
writeoutput("output with parallel threads taken from server for arr[264]:" )
arrayeach(array=arr,callback=callback,parallel=true)
try{
writeoutput("with negative thread ,should throw exception:" & "<br>")
arr.each(callback,true,-5)
}
catch(any e){
writeoutput("Type: " & e.type & " Message:" & e.message )
}
try{
writeoutput("<br>with more than 50 thread ,should throw exception:" & "<br>")
arr.each(callback,true,105)
}
catch(any e){
writeoutput("Type: " & e.type & " Message:" & e.message )
}
</cfscript>
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
|
