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">
SELECT    Username, 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>

CFML Language Reference
Chapter 2 : ColdFusion Functions