lreplace man page on YellowDog

Man page or keyword search:  
man Server   18644 pages
apropos Keyword Search (all sections)
Output format
YellowDog logo
[printable version]

lreplace(n)		     Tcl Built-In Commands		   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 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 ele‐
       ment  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 elements 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

SEE ALSO
       list(n), lappend(n),  lindex(n),	 linsert(n),  llength(n),  lsearch(n), │
       lset(n), lrange(n), lsort(n)

KEYWORDS
       element, list, replace

Tcl				      7.4			   lreplace(n)
[top]

List of man pages available for YellowDog

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net