pcre_study(3) [linux man page]

PCRE_STUDY(3)						     Library Functions Manual						     PCRE_STUDY(3)

NAME

       PCRE - Perl-compatible regular expressions

SYNOPSIS


       #include <pcre.h>

       pcre_extra *pcre_study(const pcre *code, int options,
	    const char **errptr);

DESCRIPTION


       This  function  studies	a  compiled pattern, to see if additional information can be extracted that might speed up matching. Its arguments
       are:

	 code	    A compiled regular expression
	 options    Options for pcre_study()
	 errptr     Where to put an error message

       If the function succeeds, it returns a value that can be passed to pcre_exec() via its extra argument.

       If the function returns NULL, either it could not find any additional information, or there was an error. You can tell  the  difference	by
       looking at the error value. It is NULL in first case.

       There are currently no options defined; the value of the second argument should always be zero.

       There is a complete description of the PCRE native API in the pcreapi page and a description of the POSIX API in the pcreposix page.

																     PCRE_STUDY(3)

PCRE_COMPILE2(3)					     Library Functions Manual						  PCRE_COMPILE2(3)

NAME

       PCRE - Perl-compatible regular expressions

SYNOPSIS


       #include <pcre.h>

       pcre *pcre_compile2(const char *pattern, int options,
	    int *errorcodeptr,
	    const char **errptr, int *erroffset,
	    const unsigned char *tableptr);

DESCRIPTION


       This  function compiles a regular expression into an internal form. It is the same as pcre_compile(), except for the addition of the error-
       codeptr argument. The arguments are:

	 pattern       A zero-terminated string containing the
			 regular expression to be compiled
	 options       Zero or more option bits
	 errorcodeptr  Where to put an error code
	 errptr        Where to put an error message
	 erroffset     Offset in pattern where error was found
	 tableptr      Pointer to character tables, or NULL to
			 use the built-in default

       The option bits are:

	 PCRE_ANCHORED	       Force pattern anchoring
	 PCRE_AUTO_CALLOUT     Compile automatic callouts
	 PCRE_CASELESS	       Do caseless matching
	 PCRE_DOLLAR_ENDONLY   $ not to match newline at end
	 PCRE_DOTALL	       . matches anything including NL
	 PCRE_DUPNAMES	       Allow duplicate names for subpatterns
	 PCRE_EXTENDED	       Ignore whitespace and # comments
	 PCRE_EXTRA	       PCRE extra features
				 (not much use currently)
	 PCRE_FIRSTLINE        Force matching to be before newline
	 PCRE_MULTILINE        ^ and $ match newlines within data
	 PCRE_NEWLINE_ANY      Recognize any Unicode newline sequence
	 PCRE_NEWLINE_ANYCRLF  Recognize CR, LF, and CRLF as newline sequences
	 PCRE_NEWLINE_CR       Set CR as the newline sequence
	 PCRE_NEWLINE_CRLF     Set CRLF as the newline sequence
	 PCRE_NEWLINE_LF       Set LF as the newline sequence
	 PCRE_NO_AUTO_CAPTURE  Disable numbered capturing paren-
				 theses (named ones available)
	 PCRE_UNGREEDY	       Invert greediness of quantifiers
	 PCRE_UTF8	       Run in UTF-8 mode
	 PCRE_NO_UTF8_CHECK    Do not check the pattern for UTF-8
				 validity (only relevant if
				 PCRE_UTF8 is set)

       PCRE must be built with UTF-8 support in order to use PCRE_UTF8 and PCRE_NO_UTF8_CHECK.

       The yield of the function is a pointer to a private data structure that contains the compiled pattern, or NULL if an  error  was  detected.
       Note  that  compiling regular expressions with one version of PCRE for use with a different version is not guaranteed to work and may cause
       crashes.

       There is a complete description of the PCRE native API in the pcreapi page and a description of the POSIX API in the pcreposix page.

																  PCRE_COMPILE2(3)