51 lines
1.7 KiB
Plaintext
51 lines
1.7 KiB
Plaintext
'\"
|
|
'\" 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.
|
|
'\"
|
|
.so man.macros
|
|
.TH linsert n 8.2 Tcl "Tcl Built-In Commands"
|
|
.BS
|
|
'\" Note: do not modify the .SH NAME line immediately below!
|
|
.SH NAME
|
|
linsert \- Insert elements into a list
|
|
.SH SYNOPSIS
|
|
\fBlinsert \fIlist index element \fR?\fIelement element ...\fR?
|
|
.BE
|
|
|
|
.SH DESCRIPTION
|
|
.PP
|
|
This command produces a new list from \fIlist\fR by inserting all of the
|
|
\fIelement\fR arguments just before the \fIindex\fR'th element of
|
|
\fIlist\fR. Each \fIelement\fR argument will become a separate element of
|
|
the new list. If \fIindex\fR is less than or equal to zero, then the new
|
|
elements are inserted at the beginning of the list.
|
|
.VS 8.5
|
|
The interpretation of the \fIindex\fR value is the same as
|
|
for the command \fBstring index\fR, supporting simple index
|
|
arithmetic and indices relative to the end of the list.
|
|
.VE
|
|
.SH EXAMPLE
|
|
Putting some values into a list, first indexing from the start and
|
|
then indexing from the end, and then chaining them together:
|
|
.CS
|
|
set oldList {the fox jumps over the dog}
|
|
set midList [\fBlinsert\fR $oldList 1 quick]
|
|
set newList [\fBlinsert\fR $midList end-1 lazy]
|
|
# The old lists still exist though...
|
|
set newerList [\fBlinsert\fR [\fBlinsert\fR $oldList end-1 quick] 1 lazy]
|
|
.CE
|
|
|
|
.SH "SEE ALSO"
|
|
list(n), lappend(n), lindex(n), llength(n), lsearch(n),
|
|
lset(n), lsort(n), lrange(n), lreplace(n),
|
|
.VS 8.5
|
|
string(n)
|
|
.VE
|
|
|
|
.SH KEYWORDS
|
|
element, insert, list
|