LISTTOARRAY | |
Description
Copies the elements of a list to an array. |
|
Returns
An array |
|
Category
Array functions, Conversion functions, List functions |
|
Function syntaxListToArray(list [, delimiters ]) |
|
See also
ArrayToList; Chapter 5, "Using Arrays and Structures," in ColdFusion MX Developer's Guide |
|
Parameters
|
|
Usage
ColdFusion ignores empty list elements; thus, the list "a,b,c,,,d" has four elements. ColdFusion treats each character in the delimiters parameter as a separate delimiter. Therefore, if the parameter is ",+" ColdFusion will break the list at either a comma or a plus sign. |
|
Example<h3>ListToArray Example</h3> <!--- Find a list of users who wrote messages ---> <cfquery name = "GetMessageUser" datasource = "cfdocexamples"> 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 | |
DELIMITERS | |