Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
Tcl_StringMatch(3)	     Tcl Library Procedures	      Tcl_StringMatch(3)

________________________________________________________________________________

NAME
     Tcl_StringMatch, Tcl_StringCaseMatch - test whether a string matches a pat-
     tern

SYNOPSIS
     #include <tcl.h>

     int
     Tcl_StringMatch(str, pattern)

     int
     Tcl_StringCaseMatch(str, pattern, flags)

ARGUMENTS
     const char *str (in)	       String to test.

     const char *pattern (in)	       Pattern	to  match  against  string.  May
				       contain special characters from	the  set
				       *?\[].

     int flags (in)		       OR-ed  combination  of  match flags, cur-
				       rently only TCL_MATCH_NOCASE.   0  speci-
				       fies a case-sensitive search.
________________________________________________________________________________

DESCRIPTION
     This utility procedure determines whether a string matches a given pattern.
     If  it does, then Tcl_StringMatch returns 1.  Otherwise Tcl_StringMatch re-
     turns 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
     TCL_MATCH_NOCASE),  then  the string and pattern are essentially matched in
     the lower case.

KEYWORDS
     match, pattern, string

Tcl				       8.5		      Tcl_StringMatch(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=Tcl_StringMatch.tcl86&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help