NAME

       Tcl_StringMatch,  Tcl_StringCaseMatch  -  test  whether  a
       string matches a pattern


SYNOPSIS

       #include <tcl.h>

       int
       Tcl_StringMatch(string, pattern)

       Tcl_StringCaseMatch(string, pattern, nocase)               |


ARGUMENTS

       char         *string            (in)      String to  test.

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

       int          nocase             (in)                              ||
                                                 Specifies        |
                                                 whether      the |
                                                 match  should be |
                                                 done case-sensi­ |
                                                 tive    (0)   or |
                                                 case-insensitive |
                                                 (1).
_________________________________________________________________



DESCRIPTION

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

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



KEYWORDS

       match, pattern, string