Tcl Built-In Commands                                  lrange(1T)





NAME
     lrange - Return one or more adjacent elements from a list

SYNOPSIS
     lrange list first last



DESCRIPTION
     List must be a valid Tcl list.  This command will  return  a
     new   list   consisting  of  elements  first  through  last,
     inclusive.  First or last may be end (or any abbreviation of
     it)  to  refer to the last element of the list.  If first is
     less than zero, it is treated as if it were zero.   If  last
     is  greater  than  or equal to the number of elements in the
     list, then it is treated as if it were  end.   If  first  is
     greater  than  last then an empty string is returned.  Note:
     ``lrange list first first'' does not always produce the same
     result  as ``lindex list first'' (although it often does for
     simple fields that aren't enclosed in braces); it does, how-
     ever,  produce  exactly  the  same results as ``list [lindex
     list first]''

EXAMPLES
     Selecting the first two elements:
          % lrange {a b c d e} 0 1
          a b

     Selecting the last three elements:
          % lrange {a b c d e} end-2 end
          c d e

     Selecting everything except the first and last element:
          % lrange {a b c d e} 1 end-1
          b c d

     Selecting a single element with lrange is not  the  same  as
     doing so with lindex:
          % set var {some {elements to} select}
          some {elements to} select
          % lindex $var 1
          elements to
          % lrange $var 1 1
          {elements to}


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




Tcl                     Last change: 7.4                        1






Tcl Built-In Commands                                  lrange(1T)



KEYWORDS
     element, list, range, sublist

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

     
       ATRIBUTE TYPE     ATRIBUTE VALUE
    
     Availability         SUNWTcl        
    
     Interface Stability  Uncommitted    
    

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






































Tcl                     Last change: 7.4                        2