NAME

       Tcl_StringMatch, Tcl_StringCaseMatch - test whether a string matches a pattern

SYNOPSIS

       #include <tcl.h>

       int
       Tcl_StringMatch(string, pattern)

       int
       Tcl_StringCaseMatch(string, pattern, nocase)

ARGUMENTS

       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 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 algorithm 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