string.listEach()

call the given UDF/Closure with every value in the string list.

string.listEach( closure=function, delimiter=string, includeEmptyFields=boolean, multiCharacterDelimiter=boolean, parallel=boolean, maxThreads=number )

Returns: void

Argument Description
closure
function, required

function/closure that implements the following constructor

function(element, index, list){}

Alias: function, callback, udf

delimiter
string, optional

delimiter used to separate the string list

includeEmptyFields
boolean, optional

include empty fields or not

multiCharacterDelimiter
boolean, optional

specify whether the delimiters parameter is a multi-character delimiter.

If this parameter is true, the delimiters parameter must specify a single delimiter consisting of multiple characters.

This parameter enables the ListToArray() function to convert a list such as the following to an array of color names: red:|orange:|yellow:|green:|blue:|indigo:|violet.

parallel
boolean, optional

execute closures parallel

maxThreads
number, optional

maximum number of threads executed, ignored when argument "parallel" is set to false

Examples

strList="I,Love,Lucee";
	strList.listEach(function(element,index,list) {
    	writeOutput("#index#:#element#;<br>");
	});

See also