lreplace(n)                  Tcl ( )                  lreplace(n)



     _________________________________________________________________

     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 gives
          the index in list of the first element to be  replaced.   If
          first  is less than zero then it refers to the first element
          of list;  the element indicated by first must exist  in  the
          list.   Last  gives the index in list of the last element to
          be replaced;  it must be greater than  or  equal  to  first.
          Last may be end (or any abbreviation of it) to indicate that
          all elements between first and the end of the list should be
          replaced.   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 elements between first and last are simply deleted.


     KEYWORDS
          element, list, replace


























     Page 1                                         (printed 11/11/93)