This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

This manual page is associated with the Mac OS X developer tools. The software or headers described may not be present on your Mac OS X installation until you install the developer tools package. This package is available on your Mac OS X installation DVD, and the latest versions can be downloaded from developer.apple.com.

For more information about the manual page format, see the manual page for manpages(5).

Tcl_StringMatch(3)                         Tcl Library Procedures                         Tcl_StringMatch(3)



____________________________________________________________________________________________________________

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 char-acters characters
                                                 acters 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 essen- |
       tially matched in the lower case.


KEYWORDS
       match, pattern, string



Tcl                                                  8.1                                  Tcl_StringMatch(3)