
Contents > CFML Reference > ColdFusion Functions > ListToArray

ListToArray

Copies the elements of a list to an array.

An array

Array functions, Conversion functions, List functions

ListToArray(list [, delimiters ])

ArrayToList

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.

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.

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.


Contents > CFML Reference > ColdFusion Functions > ListToArray

Version 6.1

Comments are no longer accepted for ColdFusion MX 6.1. ColdFusion 8 is the current version.

Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/coldfusion/6.1/htmldocs/functb21.htm