Subversion Repositories or1k_old

'\"

'\" Copyright (c) 1993 The Regents of the University of California.

'\" Copyright (c) 1994-1996 Sun Microsystems, Inc.

'\"

'\" See the file "license.terms" for information on usage and redistribution

'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.

'\"

'\" RCS: @(#) $Id: lindex.n,v 1.1.1.1 2002-01-16 10:25:24 markom Exp $

'\"

.so man.macros

.TH lindex n 7.4 Tcl "Tcl Built-In Commands"

.BS

'\" Note:  do not modify the .SH NAME line immediately below!

.SH NAME

lindex \- Retrieve an element from a list

.SH SYNOPSIS

\fBlindex \fIlist index\fR

.BE

.SH DESCRIPTION

.PP

This command treats \fIlist\fR as a Tcl list and returns the

\fIindex\fR'th element from it (0 refers to the first element of the list).

In extracting the element, \fIlindex\fR observes the same rules

concerning braces and quotes and backslashes as the Tcl command

interpreter; however, variable

substitution and command substitution do not occur.

If \fIindex\fR is negative or greater than or equal to the number

of elements in \fIvalue\fR, then an empty

string is returned.

If \fIindex\fR has the value \fBend\fR, it refers to the last element

in the list.

.SH KEYWORDS

element, index, list