Tcl Built-In Commands                                 linsert(1T)





NAME
     linsert - Insert elements into a list

SYNOPSIS
     linsert list index element ?element element ...?



DESCRIPTION
     This command produces a new list from list by inserting  all
     of the element arguments just before the index'th element of
     list.  Each element argument will become a separate  element
     of  the  new  list.  If index is less than or equal to zero,
     then the new elements are inserted at the beginning  of  the
     list.   If index has the value end, or if it is greater than
     or equal to the number of elements in the list, then the new
     elements  are  appended  to the list.  end-integer refers to
     the last element in the list  minus  the  specified  integer
     offset.

EXAMPLE
     Putting some values into a list,  first  indexing  from  the
     start and then indexing from the end, and then chaining them
     together:
          set oldList {the fox jumps over the dog}
          set midList [linsert $oldList 1 quick]
          set newList [linsert $midList end-1 lazy]
          # The old lists still exist though...
          set newerList [linsert [linsert $oldList end-1 quick] 1 lazy]


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


KEYWORDS
     element, insert, list

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











Tcl                     Last change: 8.2                        1






Tcl Built-In Commands                                 linsert(1T)



     
       ATRIBUTE TYPE     ATRIBUTE VALUE
    
     Availability         SUNWTcl        
    
     Interface Stability  Uncommitted    
    

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













































Tcl                     Last change: 8.2                        2