Copies the elements of a list to an array.
An array
Array functions, Conversion functions, List functions
ListToArray(list [, delimiters ])
| Parameter | Description |
|---|---|
list |
A list or a variable that contains one. You define a list variable with a |
delimiters |
A string or a variable that contains one. ColdFusion treats each character in the string as a delimiter. Default: comma. |
ColdFusion ignores empty list elements; thus, the list "a,b,c,,,d" has four elements.
ColdFusion treats each character in the delimiters attribute as a separate delimiter. Therefore, if the attribute is ",+" ColdFusion will break the list at either a comma plus sign.
<h3>ListToArray Example</h3> <!--- Find a list of users who wrote messages ---> <cfquery name = "GetMessageUser" datasource = "cfsnippets"> SELECT Username, Subject, Posted FROM Messages </cfquery> <cfset myList = ValueList(GetMessageUser.UserName)> <p>My list is a list with <cfoutput>#ListLen(myList)#</cfoutput> elements. <cfset myArrayList = ListToArray(myList)> <p>My array list is an array with <cfoutput>#ArrayLen(myArrayList)# </cfoutput> elements.