summaryrefslogtreecommitdiffstats
path: root/tcl8.6/doc/lreplace.n
diff options
context:
space:
mode:
authorWilliam Joye <wjoye@cfa.harvard.edu>2018-12-25 17:45:11 (GMT)
committerWilliam Joye <wjoye@cfa.harvard.edu>2018-12-25 17:45:11 (GMT)
commit5f5fd2864a3193a8d5da12fcb92ba7379084c286 (patch)
treebcdca927ed2a7b05c647b9a6bfdfd4a7ca5c730e /tcl8.6/doc/lreplace.n
parent535baffcecf6e738102fc12cda0109bc963e150f (diff)
downloadblt-5f5fd2864a3193a8d5da12fcb92ba7379084c286.zip
blt-5f5fd2864a3193a8d5da12fcb92ba7379084c286.tar.gz
blt-5f5fd2864a3193a8d5da12fcb92ba7379084c286.tar.bz2
update tcl/tk
Diffstat (limited to 'tcl8.6/doc/lreplace.n')
-rw-r--r--tcl8.6/doc/lreplace.n106
1 files changed, 0 insertions, 106 deletions
diff --git a/tcl8.6/doc/lreplace.n b/tcl8.6/doc/lreplace.n
deleted file mode 100644
index 32b7356..0000000
--- a/tcl8.6/doc/lreplace.n
+++ /dev/null
@@ -1,106 +0,0 @@
-'\"
-'\" Copyright (c) 1993 The Regents of the University of California.
-'\" Copyright (c) 1994-1996 Sun Microsystems, Inc.
-'\" Copyright (c) 2001 Kevin B. Kenny <kennykb@acm.org>. All rights reserved.
-'\"
-'\" See the file "license.terms" for information on usage and redistribution
-'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
-'\"
-.TH lreplace n 7.4 Tcl "Tcl Built-In Commands"
-.so man.macros
-.BS
-'\" Note: do not modify the .SH NAME line immediately below!
-.SH NAME
-lreplace \- Replace elements in a list with new elements
-.SH SYNOPSIS
-\fBlreplace \fIlist first last \fR?\fIelement element ...\fR?
-.BE
-.SH DESCRIPTION
-.PP
-\fBlreplace\fR returns a new list formed by replacing zero or more elements of
-\fIlist\fR with the \fIelement\fR arguments.
-\fIfirst\fR and \fIlast\fR are index values specifying the first and
-last elements of the range to replace.
-The index values \fIfirst\fR and \fIlast\fR are interpreted
-the same as index values for the command \fBstring index\fR,
-supporting simple index arithmetic and indices relative to the
-end of the list.
-0 refers to the first element of the
-list, and \fBend\fR refers to the last element of the list.
-.PP
-If either \fIfirst\fR or \fIlast\fR is less than zero, it is considered
-to refer to before the first element of the list. This allows \fBlreplace\fR
-to prepend elements to \fIlist\fR.
-.VS TIP505
-If either \fIfirst\fR or \fIlast\fR indicates a position greater than the
-index of the last element of the list, it is treated as if it is an
-index one greater than the last element. This allows \fBlreplace\fR to
-append elements to \fIlist\fR.
-.VE TIP505
-.PP
-If \fIlast\fR is less than \fIfirst\fR, then any specified elements
-will be inserted into the list before the element specified by \fIfirst\fR
-with no elements being deleted.
-.PP
-The \fIelement\fR arguments specify zero or more new elements to
-be added to the list in place of those that were deleted.
-Each \fIelement\fR argument will become a separate element of
-the list. If no \fIelement\fR arguments are specified, then the elements
-between \fIfirst\fR and \fIlast\fR are simply deleted.
-.SH EXAMPLES
-.PP
-Replacing an element of a list with another:
-.PP
-.CS
-% \fBlreplace\fR {a b c d e} 1 1 foo
-a foo c d e
-.CE
-.PP
-Replacing two elements of a list with three:
-.PP
-.CS
-% \fBlreplace\fR {a b c d e} 1 2 three more elements
-a three more elements d e
-.CE
-.PP
-Deleting the last element from a list in a variable:
-.PP
-.CS
-% set var {a b c d e}
-a b c d e
-% set var [\fBlreplace\fR $var end end]
-a b c d
-.CE
-.PP
-A procedure to delete a given element from a list:
-.PP
-.CS
-proc lremove {listVariable value} {
- upvar 1 $listVariable var
- set idx [lsearch -exact $var $value]
- set var [\fBlreplace\fR $var $idx $idx]
-}
-.CE
-.PP
-.VS TIP505
-Appending elements to the list; note that \fBend+2\fR will initially
-be treated as if it is \fB6\fR here, but both that and \fB12345\fR are greater
-than the index of the final item so they behave identically:
-.PP
-.CS
-% set var {a b c d e}
-a b c d e
-% set var [\fBlreplace\fR $var 12345 end+2 f g h i]
-a b c d e f g h i
-.CE
-.VE TIP505
-.SH "SEE ALSO"
-list(n), lappend(n), lindex(n), linsert(n), llength(n), lsearch(n),
-lset(n), lrange(n), lsort(n),
-string(n)
-.SH KEYWORDS
-element, list, replace
-.\" Local variables:
-.\" mode: nroff
-.\" fill-column: 78
-.\" End: