ListFirst(list [, delimiters ])

Description

Returns the first element of the list.

Category

List functions

See also

ListGetAt, ListLast, ListQualify

Parameters

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>