Tcl_StringMatch(3) Tcl Library Procedures Tcl_StringMatch(3) ______________________________________________________________________________ NAME Tcl_StringMatch, Tcl_StringCaseMatch - test whether a string(3,n) matches a pattern SYNOPSIS #include <tcl.h> int Tcl_StringMatch(string(3,n), pattern) int Tcl_StringCaseMatch(string(3,n), pattern, nocase) ARGUMENTS char *string(3,n) (in(1,8)) String to test. char *pattern (in(1,8)) Pattern to match against string. May contain special characters from the set(7,n,1 builtins) *?\[]. int nocase (in(1,8)) Specifies whether the match should be done case-sensitive (0) or case-insensitive (1). _________________________________________________________________ DESCRIPTION This utility procedure determines whether a string(3,n) 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(1,8) the ``string(3,n) match'' Tcl command and is similar to the algorithm used by the C-shell for file(1,n) 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(3,n) and pattern are essentially | matched in(1,8) the lower case. KEYWORDS match, pattern, string(3,n) Tcl 8.1 Tcl_StringMatch(3)