Lucee Function Reference
listfilter()
This function creates a new string list that returns all entries from an string list that match the given filter.
Example
listfilter(string list,function filter,[string delimiter,[boolean includeEmptyFields,[boolean multiCharacterDelimiter,[boolean parallel,[number maxThreads]]]]]):string
Category
list,string,iterator
Arguments
The arguments for this function are set. You can not use other arguments except the following ones.
| Name | Type | Required | Default Value | Description |
|---|---|---|---|---|
| list | string | Yes | list to filter entries from | |
| filter | function | Yes | function/closure that implements the following constructor [function(any value, numeric index,string list, string delimiter):boolean]. | |
| delimiter | string | No | , | delimiter used to separate the string list |
| includeEmptyFields | boolean | No | false | include empty fields or not |
| multiCharacterDelimiter | boolean | No | true | 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 | No | false | execute closures parallel |
| maxThreads | number | No | 20 | maximum number of threads executed, ignored when argument "parallel" is set to false |