# 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>