Tcl_StringMatch(3tcl)

______________________________________________________________________________

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 pat-
       tern.    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

Tcl                                   8.1                   Tcl_StringMatch(3)