linsert(n)            Tcl Built-In Commands            linsert(n)



_________________________________________________________________

NAME
     linsert - Insert elements into a list

SYNOPSIS
     linsert _l_i_s_t _i_n_d_e_x _e_l_e_m_e_n_t ?_e_l_e_m_e_n_t _e_l_e_m_e_n_t ...?
_________________________________________________________________


DESCRIPTION
     This command produces a new list from _l_i_s_t by inserting  all
     of  the _e_l_e_m_e_n_t arguments just before the _i_n_d_e_xth element of
     _l_i_s_t.  Each _e_l_e_m_e_n_t argument will become a separate  element
     of  the  new  list.  If _i_n_d_e_x is less than or equal to zero,
     then the new elements are inserted at the beginning  of  the
     list.   If _i_n_d_e_x 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.


KEYWORDS
     element, insert, list
































Tcl                     Last change: 7.4                        1