diff options
author | William Joye <wjoye@cfa.harvard.edu> | 2017-09-22 18:51:12 (GMT) |
---|---|---|
committer | William Joye <wjoye@cfa.harvard.edu> | 2017-09-22 18:51:12 (GMT) |
commit | 3fa8e6dc88e8041b6cb88d1b1e9c05676d3346b7 (patch) | |
tree | 69afbb41089c8358615879f7cd3c4cf7997f4c7e /tcl8.6/doc/lassign.n | |
parent | a0e17db23c0fd7c771c0afce8cce350c98f90b02 (diff) | |
download | blt-3fa8e6dc88e8041b6cb88d1b1e9c05676d3346b7.zip blt-3fa8e6dc88e8041b6cb88d1b1e9c05676d3346b7.tar.gz blt-3fa8e6dc88e8041b6cb88d1b1e9c05676d3346b7.tar.bz2 |
update to tcl/tk 8.6.7
Diffstat (limited to 'tcl8.6/doc/lassign.n')
-rw-r--r-- | tcl8.6/doc/lassign.n | 60 |
1 files changed, 0 insertions, 60 deletions
diff --git a/tcl8.6/doc/lassign.n b/tcl8.6/doc/lassign.n deleted file mode 100644 index e250729..0000000 --- a/tcl8.6/doc/lassign.n +++ /dev/null @@ -1,60 +0,0 @@ -'\" -'\" Copyright (c) 1992-1999 Karl Lehenbauer & Mark Diekhans -'\" Copyright (c) 2004 Donal K. Fellows -'\" -'\" See the file "license.terms" for information on usage and redistribution -'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES. -'\" -.TH lassign n 8.5 Tcl "Tcl Built-In Commands" -.so man.macros -.BS -'\" Note: do not modify the .SH NAME line immediately below! -.SH NAME -lassign \- Assign list elements to variables -.SH SYNOPSIS -\fBlassign \fIlist \fR?\fIvarName ...\fR? -.BE -.SH DESCRIPTION -.PP -This command treats the value \fIlist\fR as a list and assigns -successive elements from that list to the variables given by the -\fIvarName\fR arguments in order. If there are more variable names -than list elements, the remaining variables are set to the empty -string. If there are more list elements than variables, a list of -unassigned elements is returned. -.SH EXAMPLES -.PP -An illustration of how multiple assignment works, and what happens -when there are either too few or too many elements. -.PP -.CS -\fBlassign\fR {a b c} x y z ;# Empty return -puts $x ;# Prints "a" -puts $y ;# Prints "b" -puts $z ;# Prints "c" - -\fBlassign\fR {d e} x y z ;# Empty return -puts $x ;# Prints "d" -puts $y ;# Prints "e" -puts $z ;# Prints "" - -\fBlassign\fR {f g h i} x y ;# Returns "h i" -puts $x ;# Prints "f" -puts $y ;# Prints "g" -.CE -.PP -The \fBlassign\fR command has other uses. It can be used to create -the analogue of the -.QW shift -command in many shell languages like this: -.PP -.CS -set ::argv [\fBlassign\fR $::argv argumentToReadOff] -.CE -.SH "SEE ALSO" -lindex(n), list(n), lrange(n), lset(n), set(n) -.SH KEYWORDS -assign, element, list, multiple, set, variable -'\"Local Variables: -'\"mode: nroff -'\"End: |