This function creates a new string list that returns all entries from an string list that match the given filter.
string.listFilter( filter=function, delimiter=string, includeEmptyFields=boolean, multiCharacterDelimiter=boolean, parallel=boolean, maxThreads=number )
Returns: String
Argument |
Description |
filter
function,
required
|
A function/closure that implements the following constructor
function(any value, numeric index, string list, string delimiter) { return true/false; }
Alias: closure, function, callback
|
delimiter
string,
optional
|
delimiter used to separate the string list
|
includeEmptyFields
boolean,
optional
|
include empty fields or not
|
multiCharacterDelimiter
boolean,
optional
|
specifying whether the delimiters parameter specifies 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
Alias: maxThreadCount
|
Examples
listVal = "one,two,three,four,five";
res = listVal.listFilter(
function(elem,ind){
if(elem != "three"){
return true;
}
return false;
});
writeDump(res);
See also