ListFirst

Description

Returns the first element of the list.

Syntax

ListFirst(list [, delimiters ])

Parameters

Parameter

Description

list
List whose first element to retrieve

delimiters
Set of delimiters used in list

Parameter	Description
list	List whose first element to retrieve
delimiters	Set of delimiters used in list

Usage

Note

ColdFusion ignores empty list elements; thus, a list that is defined as "a,b,c,,,d" is treated as a four element list.

Example

<!--- This example shows ListFirst, ListLast, and ListRest --->
<html>
<head>
<title>ListFirst Example</title>
</head>

<body>
<H3>ListFirst Example</H3>

<!--- Find a list of users who wrote messages --->
<cfquery name = "GetMessageUser" datasource = "cfsnippets">
SELECT Username, Subject, Posted
FROM  Messages
</cfquery>

<cfset temp = ValueList(GetMessageUser.Username)>
<!--- Show the first user in the list --->
<P>The first user in the list is <cfoutput>#ListFirst(temp)#
 </cfoutput>.
<P>The rest of the users in the list are as follows:
<cfoutput>#ListRest(temp)#</cfoutput>.
<P>The last user in the list is <cfoutput>#ListLast(temp)#</cfoutput>

</body>
</html>