418
CFML Language Reference
ListGetAt
Returns the element at a given position.
See also
ListFirst
,
ListLast
,
ListQualify
, and
ListSetAt
.
Syntax
ListGetAt
(
list, position [, delimiters ])
list
List whose element is being retrieved.
position
Positive integer indicating the position of the element being retrieved.
delimiters
Set of delimiters used in list.
Usage
The first position in a list is denoted by the number 1, not 0.
Examples
<!--- This example shows ListGetAt and ListLen --->
<HTML>
<HEAD>
<TITLE>ListGetAt Example</TITLE>
</HEAD>
<BODY>
<H3>ListGetAt Example</H3>
<!--- Find a list of users who wrote messages --->
<CFQUERY NAME="GetMessageUser" DATASOURCE="cfsnippets">
SELECTUsername, Subject, Posted
FROM Messages
</CFQUERY>
<CFSET temp = ValueList(GetMessageUser.Username)>
<!--- loop through the list and show it with ListGetAt --->
<H3>This list of usernames who have posted messages numbers
<CFOUTPUT>#ListLen(temp)#</CFOUTPUT> users.</H3>
<UL>
<CFLOOP From="1" To="#ListLen(temp)#" INDEX="Counter">
<CFOUTPUT><LI>Username #Counter#: #ListGetAt(temp, Counter)#
</CFOUTPUT>
</CFLOOP>
</UL>
</BODY>
</HTML>
Summary of Contents for COLDFUSION 4.5-CFML LANGUAGE
Page 1: ...Allaire Corporation CFML Language Reference ColdFusion 4 5...
Page 207: ...Chapter 1 ColdFusion Tags 183 CFCATCH CFTRY BODY HTML...
Page 224: ...200 CFMLLanguageReference CFOUTPUT P Text within CFOUTPUT is always shown CFOUTPUT BODY HTML...
Page 336: ...312 CFMLLanguageReference CFIF BODY HTML...
Page 404: ...380 CFMLLanguageReference DE It is morning CFOUTPUT P BODY HTML...
Page 413: ...Chapter 2 ColdFusion Functions 389 Customer BalanceDue BR CFOUTPUT CFIF BODY HTML...
Page 483: ...Chapter 2 ColdFusion Functions 459 CFOUTPUT CFLOOP BODY HTML...
Page 584: ...560 CFMLLanguageReference...
Page 594: ...570 CFMLLanguageReference...