ListToArray

Copies the elements of a list to an array.

ListToArray( list [, delimiter [, includeEmptyFields [, multiCharacterDelimiter ] ] ] )

Returns: Array

Argument Description Default
list
string, required

a string list

delimiter
string, optional

Characters that separate list elements. The default value is comma.

,

includeEmptyFields
boolean, optional

if set to true, empty values are included as well

multiCharacterDelimiter
boolean, optional

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.

false

Examples

Simple example for listToArray function: Uses the listToArray() function to retrieve a list as an array

list = "red,green,orange"; getArray = listToArray(list); someJSON = serializeJSON(getArray); writeOutput(someJSON); 

Expected Result: ["red", "green", "orange"]

Example for listToArray function with delimiter: Uses the listToArray() function with a semicolon delimiter to retrieve a list as an array

list = "coldfusion;php;java;sql"; getArray = listToArray(list,";"); someJSON = serializeJSON(getArray); writeOutput(someJSON); 

Expected Result: ["coldfusion", "php", "java", "sql"]

Example for listToArray function with includeEmptyFields: If includeEmptyFields is true, empty value add in array elements

list = "coldfusion;php;;java;sql"; getArray = listToArray(list,";",true); someJSON = serializeJSON(getArray); writeOutput(someJSON); 

Expected Result: ["coldfusion", "php", " " , "java", "sql"]

Example for listToArray function with multiCharacterDelimiter: Uses the listToArray() function to retrieve a list as an array with multiCharacterDelimiter

list = "coldfusion,php,|test,java,|sql"; getArray = listToArray(list,",|",false,true); someJSON = serializeJSON(getArray); writeOutput(someJSON ); 

Expected Result: ["coldfusion,php", "test,java", "sql"]

See also