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, however, 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(3tcl), lappend(3tcl), lindex(3tcl), linsert(3tcl), llength(3tcl),
lsearch(3tcl), lset(3tcl), lreplace(3tcl), lsort(3tcl)
KEYWORDS¶
element, list, range, sublist