Changes a list delimiter.
Returns a copy of the list, with each delimiter character
replaced by new_delimiter.
Lucee Function Reference
Function LISTCHANGEDELIMS
Example
listchangedelims(string list,string new_delimiter,[string delimiters,[boolean includeEmptyFields,[boolean multiCharacterDelimiter]]]):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. |