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