diff options
author | nigel <nigel@2f5784b3-3f2a-0410-8824-cb99058d5e15> | 2007-02-24 21:40:03 +0000 |
---|---|---|
committer | nigel <nigel@2f5784b3-3f2a-0410-8824-cb99058d5e15> | 2007-02-24 21:40:03 +0000 |
commit | c8cb607ab7e12e185e86a8b23d413b7f9536f24c (patch) | |
tree | e1c3675d531d498d2a84490908e187a249456d2c /doc/pcre_compile.3 | |
parent | e27c89c9227398c6feee3ca0748827fd064154cd (diff) | |
download | pcre-c8cb607ab7e12e185e86a8b23d413b7f9536f24c.tar.gz |
Load pcre-4.0 into code/trunk.
git-svn-id: svn://vcs.exim.org/pcre/code/trunk@63 2f5784b3-3f2a-0410-8824-cb99058d5e15
Diffstat (limited to 'doc/pcre_compile.3')
-rw-r--r-- | doc/pcre_compile.3 | 55 |
1 files changed, 55 insertions, 0 deletions
diff --git a/doc/pcre_compile.3 b/doc/pcre_compile.3 new file mode 100644 index 0000000..f911623 --- /dev/null +++ b/doc/pcre_compile.3 @@ -0,0 +1,55 @@ +.TH PCRE 3 +.SH NAME +PCRE - Perl-compatible regular expressions +.SH SYNOPSIS +.rs +.sp +.B #include <pcre.h> +.PP +.SM +.br +.B pcre *pcre_compile(const char *\fIpattern\fR, int \fIoptions\fR, +.ti +5n +.B const char **\fIerrptr\fR, int *\fIerroffset\fR, +.ti +5n +.B const unsigned char *\fItableptr\fR); + +.SH DESCRIPTION +.rs +.sp +This function compiles a regular expression into an internal form. Its +arguments are: + + \fIpattern\fR A zero-terminated string containing the + regular expression to be compiled + \fIoptions\fR Zero or more option bits + \fIerrptr\fR Where to put an error message + \fIerroffset\fR Offset in pattern where error was found + \fItableptr\fR Pointer to character tables, or NULL to + use the built-in default + +The option bits are: + + PCRE_ANCHORED Force pattern anchoring + PCRE_CASELESS Do caseless matching + PCRE_DOLLAR_ENDONLY $ not to match newline at end + PCRE_DOTALL . matches anything including NL + PCRE_EXTENDED Ignore whitespace and # comments + PCRE_EXTRA PCRE extra features + (not much use currently) + PCRE_MULTILINE ^ and $ match newlines within data + 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 must have been compiled with UTF-8 support when PCRE_UTF8 is used. + +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. + +There is a complete description of the PCRE API in the +.\" HREF +\fBpcreapi\fR +.\" +page. |