NAME
lsearch - See if a list contains a particular element
SYNOPSIS
lsearch ?mode? list pattern
DESCRIPTION
This command searches the elements of list to see if one of them matches
pattern. If so, the command returns the index of the first matching
element. If not, the command returns -1. The mode argument indicates how
the elements of the list are to be matched against pattern and it must
have one of the following values:
-exact
The list element must contain exactly the same string as pattern.
-glob
Pattern is a glob-style pattern which is matched against each list
element using the same rules as the string match command.
-regexp
Pattern is treated as a regular expression and matched against each list
element using the same rules as the regexp command.
If mode is omitted then it defaults to -glob.
EXAMPLE
% set x {ABC DEF {GHI JKL} MNO}
ABC DEF {GHI JKL} MNO
% lsearch $x G*
2
% lsearch $x MNO
3
% lsearch -glob $x D*
1
% lsearch -exact $x ABC
0
% lsearch -exact $x mno
-1
SEE ALSO
lappend lindex linsert list llength lrange lreplace lsort