Manual Pages for UNIX Operating System command usage for man lreplace

Tcl Built-In Commands                                lreplace(1T)



_________________________________________________________________

NAME
     lreplace - Replace elements in a list with new elements

SYNOPSIS
     lreplace list first last ?element element ...?
_________________________________________________________________


DESCRIPTION
     lreplace returns a new list formed by replacing one or  more
     elements of list with the element arguments.  first and last
     specify the first and last index of the range of elements to
     replace.  0 refers to the first element of the list, and end
     (or any abbreviation of it) may be used to refer to the last
     element  of the list.  If list is empty, then first and last
     are ignored.

     If first is less than zero, it is considered to refer to the
     first element of the list.  For non-empty lists, the element
     indicated by first must exist.

     If last is less than zero but greater than first,  then  any
     specified  elements  will be prepended to the list.  If last
     is less than first then no elements  are  deleted;  the  new
     elements are simply inserted before first.

     The element arguments specify zero or more new arguments  to
     be  added  to  the list in place of those that were deleted.
     Each element argument will become a separate element of  the
     list.   If no element arguments are specified, then the ele-
     ments between first and last are simply deleted.  If list is
     empty,  any  element  arguments  are added to the end of the
     list.

EXAMPLES
     Replacing an element of a list with another:
          % lreplace {a b c d e} 1 1 foo
          a foo c d e

     Replacing two elements of a list with three:
          % lreplace {a b c d e} 1 2 three more elements
          a three more elements d e

     Deleting the last element from a list in a variable:
          % set var {a b c d e}
          a b c d e
          % set var [lreplace $var end end]
          a b c d





Tcl                     Last change: 7.4                        1






Tcl Built-In Commands                                lreplace(1T)



SEE ALSO
     list(1T), lappend(1T), lindex(1T), linsert(1T), llength(1T),  |
     lsearch(1T), lset(1T), lrange(1T), lsort(1T)


KEYWORDS
     element, list, replace

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     _______________________________________
    |   ATTRIBUTE TYPE   |  ATTRIBUTE VALUE|
    |____________________|__________________|_
    | Availability       |  runtime/tcl-8  |
    |____________________|__________________|_
    | Interface Stability|  Uncommitted    |
    |____________________|_________________|

NOTES
     Source for Tcl is available on http://opensolaris.org.

































Tcl                     Last change: 7.4                        2