HPUX RegExp[3]

 Tcl_RegExpMatch(3)                  Tcl                  Tcl_RegExpMatch(3)

 Tcl Library Procedures                               Tcl Library Procedures

                                     7.0



 ___________________________________________________________________________

 NAME
      Tcl_RegExpMatch - Test whether a string matches a regular expression

 SYNOPSIS
      #include <tcl.h>

      int
      Tcl_RegExpMatch(interp, string, regexp)

 ARGUMENTS
      Tcl_Interp   *interp   (in)      Tcl  interpreter  to  use  for  error
                                       reporting.

      char         *string   (in)      String to test.

      char         *regexp   (in)      Regular expression to  match  against
                                       string.
 ___________________________________________________________________________


 DESCRIPTION
      Tcl_RegExpMatch determines whether its string argument matches regexp,
      where  regexp  is  interpreted  as a regular expression using the same
      rules as for the regexp  Tcl  command.   If  there  is  a  match  then
      Tcl_RegExpMatch  returns 1.  If there is no match then Tcl_RegExpMatch
      returns 0.  If an error occurs in the matching process (e.g. regexp is
      not  a  valid  regular expression) then Tcl_RegExpMatch returns -1 and
      leaves an error message in interp->result.


 KEYWORDS
      match, regular expression, string


















                                    - 1 -        Formatted:  August 11, 1996