36 lines
1.1 KiB
Plaintext
36 lines
1.1 KiB
Plaintext
'\"
|
|
'\" 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.
|
|
'\"
|
|
'\" SCCS: @(#) lindex.n 1.8 96/08/26 13:00:02
|
|
'\"
|
|
.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
|