ListToArray

Converts the specified list into an array.

See also ArrayToList.

Syntax

ListToArray(list [, delimiter ])
list

Name of the list variable that contains the elements to be used to build an array. You can define a list variable with a CFSET statement. The items in the list must be separated by commas or otherwise delimited.

delimiter

Specify the character(s) used to delimit elements in the list. Default is comma ( , ).

Example

<!--- This example shows ListToArray --->
<HTML>
<HEAD>
<TITLE>ListToArray Example</TITLE>
</HEAD>

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

</BODY>
</HTML>       



1