Lucee Function Reference

listtoarray()

Copies the elements of a list to an array.

Example

listtoarray(string list,[string delimiter,[boolean includeEmptyFields,[boolean multiCharacterDelimiter]]]):array

Category

list,string,array

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   a string list  
delimiter string  No , Characters that separate list elements. The default value is comma.  
includeEmptyFields boolean  No   if set to true, empty values are included as well  
multiCharacterDelimiter boolean  No false specifying whether the delimiters parameter specifies a multi-character delimiter. The default is false. 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.