listToArray

Copies the elements of a list to an array.

listToArray(list [, delimiters] [, includeEmptyFields] [, multiCharacterDelimiter]) → returns Array

listToArray Argument Reference

list
Required

A list or variable name

delimiters
Default: ,

Values:
  • ,
  • |
  • ;
  • chr(9)
  • chr(10)
  • chr(13)

includeEmptyFields

A Boolean value specifying whether to create empty array entries if there are two delimiters in a row.

multiCharacterDelimiter

A Boolean value specifying whether the delimiters parameter specifies a multi-character delimiter.

Examples sample code invoking the listToArray function


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"]


Fork me on GitHub