12.5.24    linsert

Description:   Insert elements into a list

Syntax:         linsert list index element ?element element ...?


Argument:     list, index, element(s)

Returns:        a list of values, with spaces between elements

See Also:       list, llength, lappend, foreach, append, concat


Examples:      linsert mylist  3 "third choice"

# insert "third choice" as a single element

# in the third position of mylist


Inserts all of the element arguments just before the indexth element of list. Creates list if it does not exist 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.