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>

A list or a variable that contains one.

LIST  

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.

DELIMITERS