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 syntaxListRest(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: <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: <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> |
LIST | |
DELIMITERS | |