Tcl_StringMatch(3)    Tcl Library Procedures   Tcl_StringMatch(3)



_________________________________________________________________

NAME
       Tcl_StringMatch,  Tcl_StringCaseMatch  -  test  whether  a
       string matches a pattern

SYNOPSIS
       #include 

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



Tcl                            8.1             Tcl_StringMatch(3)