ListToArray |
Description
Copies the elements of a list to an array.
Returns
An array
Category
Array functions, Conversion functions, List functions
Function syntax

    ListToArray(list [, delimiters ])

See also
ArrayToList
Parameters

Parameter | Description
list | A list or a variable that contains one.
| You define a list variable with a cfset statement.
delimiters | A string or a variable that contains one. ColdFusion treats each character in the
| string as a delimiter. Default: comma.

Usage
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.

Example

    <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.

list |
A list or a variable that contains one.
You define a list variable with a cfset statement.

delimiters |
A string or a variable that contains one. ColdFusion treats each character in the string as a delimiter. Default: comma.