Home Man
Today's Posts

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:
Select Section of Man Page:
Select Man Page Repository:

Linux 2.6 - man page for pcre_compile2 (linux section 3)


       PCRE - Perl-compatible regular expressions


       #include <pcre.h>

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


       This  function  compiles  a  regular  expression  into an internal form. It is the same as
       pcre_compile(), except for the addition of the errorcodeptr 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_BSR_ANYCRLF	 \R matches only CR, LF, or CRLF
	 PCRE_BSR_UNICODE	 \R matches all Unicode line endings
	 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_JAVASCRIPT_COMPAT  JavaScript compatibility
	 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
	 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_NO_UTF8_CHECK	 Do not check the pattern for UTF-8
				   validity (only relevant if
				   PCRE_UTF8 is set)
	 PCRE_UCP		 Use Unicode properties for \d, \w, etc.
	 PCRE_UNGREEDY		 Invert greediness of quantifiers
	 PCRE_UTF8		 Run in UTF-8 mode

       PCRE must be built with UTF-8 support in order to use  PCRE_UTF8  and  PCRE_NO_UTF8_CHECK,
       and with UCP support if PCRE_UCP is used.

       The  yield of the function is a pointer to a private data structure that contains the com-
       piled 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  descrip-
       tion of the POSIX API in the pcreposix page.


All times are GMT -4. The time now is 11:40 AM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
Show Password

Not a Forum Member?
Forgot Password?