Lucee Function Reference

Function LISTCHANGEDELIMS

Changes a list delimiter.
Returns a copy of the list, with each delimiter character
replaced by new_delimiter.

Example

listchangedelims(string list,string new_delimiter,[string delimiters,[boolean includeEmptyFields,[boolean multiCharacterDelimiter]]]):string

Category

list,string

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  
new_delimiter string  Yes   new delimiter to set. a delimiter is a characters that separate list elements.  
delimiters string  No , existing delimiter to replace. a delimiter is a characters that separate list elements. The default value is comma.  
includeEmptyFields boolean  No false if set to true, empty values are included as well  
multiCharacterDelimiter boolean  No false 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.