'\"
|
'\"
|
'\" Copyright (c) 1993 The Regents of the University of California.
|
'\" Copyright (c) 1993 The Regents of the University of California.
|
'\" Copyright (c) 1994-1996 Sun Microsystems, Inc.
|
'\" Copyright (c) 1994-1996 Sun Microsystems, Inc.
|
'\"
|
'\"
|
'\" See the file "license.terms" for information on usage and redistribution
|
'\" See the file "license.terms" for information on usage and redistribution
|
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
|
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
|
'\"
|
'\"
|
'\" RCS: @(#) $Id: list.n,v 1.1.1.1 2002-01-16 10:25:24 markom Exp $
|
'\" RCS: @(#) $Id: list.n,v 1.1.1.1 2002-01-16 10:25:24 markom Exp $
|
'\"
|
'\"
|
.so man.macros
|
.so man.macros
|
.TH list n "" Tcl "Tcl Built-In Commands"
|
.TH list n "" Tcl "Tcl Built-In Commands"
|
.BS
|
.BS
|
'\" Note: do not modify the .SH NAME line immediately below!
|
'\" Note: do not modify the .SH NAME line immediately below!
|
.SH NAME
|
.SH NAME
|
list \- Create a list
|
list \- Create a list
|
.SH SYNOPSIS
|
.SH SYNOPSIS
|
\fBlist \fR?\fIarg arg ...\fR?
|
\fBlist \fR?\fIarg arg ...\fR?
|
.BE
|
.BE
|
|
|
.SH DESCRIPTION
|
.SH DESCRIPTION
|
.PP
|
.PP
|
This command returns a list comprised of all the \fIarg\fRs,
|
This command returns a list comprised of all the \fIarg\fRs,
|
or an empty string if no \fIarg\fRs are specified.
|
or an empty string if no \fIarg\fRs are specified.
|
Braces and backslashes get added as necessary, so that the \fBindex\fR command
|
Braces and backslashes get added as necessary, so that the \fBindex\fR command
|
may be used on the result to re-extract the original arguments, and also
|
may be used on the result to re-extract the original arguments, and also
|
so that \fBeval\fR may be used to execute the resulting list, with
|
so that \fBeval\fR may be used to execute the resulting list, with
|
\fIarg1\fR comprising the command's name and the other \fIarg\fRs comprising
|
\fIarg1\fR comprising the command's name and the other \fIarg\fRs comprising
|
its arguments. \fBList\fR produces slightly different results than
|
its arguments. \fBList\fR produces slightly different results than
|
\fBconcat\fR: \fBconcat\fR removes one level of grouping before forming
|
\fBconcat\fR: \fBconcat\fR removes one level of grouping before forming
|
the list, while \fBlist\fR works directly from the original arguments.
|
the list, while \fBlist\fR works directly from the original arguments.
|
For example, the command
|
For example, the command
|
.CS
|
.CS
|
\fBlist a b {c d e} {f {g h}}\fR
|
\fBlist a b {c d e} {f {g h}}\fR
|
.CE
|
.CE
|
will return
|
will return
|
.CS
|
.CS
|
\fBa b {c d e} {f {g h}}\fR
|
\fBa b {c d e} {f {g h}}\fR
|
.CE
|
.CE
|
while \fBconcat\fR with the same arguments will return
|
while \fBconcat\fR with the same arguments will return
|
.CS
|
.CS
|
\fBa b c d e f {g h}\fR
|
\fBa b c d e f {g h}\fR
|
.CE
|
.CE
|
|
|
.SH KEYWORDS
|
.SH KEYWORDS
|
element, list
|
element, list
|
|
|
