TclStringMatch(3) Tcl Library Procedures TclStringMatch(3)

NAME
       TclStringMatch,  TclStringCaseMatch - test whether a string matches a
       pattern

SYNOPSIS
       ##iinncclluuddee <>

       int
       TTccllSSttrriinnggMMaattcchh(string, pattern)

       int
       TTccllSSttrriinnggCCaasseeMMaattcchh(string, pattern, nocase)

AARRGGUUMMEENNTTSS
       char         *string            (in)      String to test.

       char         *pattern           (in)      Pattern  to   match   against
                                                 string.   May contain special
                                                 characters   from   the   set
                                                 *?\[].

       int          nocase             (in)      Specifies  whether  the match
                                                 should be done case-sensitive
                                                 (0)  or case-insensitive (1).



DESCRIPTION
       This utility procedure determines whether a string matches a given pat-
       tern.    If   it  does,  then  TTccllSSttrriinnggMMaattcchh  returns  1.   Otherwise
       TTccllSSttrriinnggMMaattcchh returns 0.  The algorithm used for matching is the same
       algorithm  used  in  the ``string match'' Tcl command and is similar to
       the algorithm used by the C-shell for file name matching;  see the  Tcl
       manual entry for details.                                               |

       In  TTccllSSttrriinnggCCaasseeMMaattcchh,  the  algorithm  is the same, but you have the |
       option to make the matching case-insensitive.  If you choose  this  (by |
       passing  nnooccaassee  as  1),  then  the  string and pattern are essentially |
       matched in the lower case.


KKEEYYWWOORRDDSS
       match, pattern, string



Tcl                                   8.1                   TclStringMatch(3)