User Guide

ListRest 733
ListRest
Description
Gets a list, without its first element.
Returns
A copy of list, without the first element. If list has one element, returns an empty list.
Category
List functions
Function syntax
ListRest(list [, delimiters ])
See also
ListFirst
, ListGetAt, ListLast; “Lists” in Chapter 3, “Using ColdFusion Variables,” in
ColdFusion MX Developer’s Guide
Parameters
Usage
If the list begins with one or more empty entries, this function drops them, as well as the first
element.
ColdFusion ignores empty list elements; thus, the list "a,b,c,,,d" has four elements.
Example
<h3>ListFirst, ListLast, and ListRest Example</h3>
<!--- Find a list of users who wrote messages --->
<cfquery name = "GetMessageUser" datasource = "cfdocexamples">
SELECT Username, Subject, Posted
FROM Messages
</cfquery>
<cfset temp = ValueList(GetMessageUser.Username)>
<p>Before editing the list, it is:&nbsp;
<cfoutput>#ValueList(GetMessageUser.Username)#</cfoutput>.
<p>(Users who posted more than once are listed more than once.)
<p>The first user in the list is:
<cfoutput>#ListFirst(temp)# </cfoutput>
<p>The rest of the list is:&nbsp;<cfoutput>#ListRest(temp)#</cfoutput>.
<p>(Users who posted more than once are listed more than once.)
<p>The last user in the list is: <cfoutput>#ListLast(temp)#</cfoutput>
Parameter Description
list A list or a variable that contains one.
delimiters A string or a variable that contains one. Character(s) that separate list elements.
The default value is comma.
If this parameter contains more than one character, ColdFusion processes each
occurrence of each character as a delimiter.