diff options
Diffstat (limited to 'doc/html/pcre2_compile.html')
-rw-r--r-- | doc/html/pcre2_compile.html | 32 |
1 files changed, 21 insertions, 11 deletions
diff --git a/doc/html/pcre2_compile.html b/doc/html/pcre2_compile.html index 544f4fe..0a9eafa 100644 --- a/doc/html/pcre2_compile.html +++ b/doc/html/pcre2_compile.html @@ -37,26 +37,34 @@ arguments are: <i>erroffset</i> Where to put an error offset <i>ccontext</i> Pointer to a compile context or NULL </pre> -The length of the string and any error offset that is returned are in code -units, not characters. A compile context is needed only if you want to change +The length of the pattern and any error offset that is returned are in code +units, not characters. A compile context is needed only if you want to provide +custom memory allocation functions, or to provide an external function for +system stack size checking, or to change one or more of these parameters: <pre> - What \R matches (Unicode newlines or CR, LF, CRLF only) - PCRE2's character tables - The newline character sequence - The compile time nested parentheses limit + What \R matches (Unicode newlines, or CR, LF, CRLF only); + PCRE2's character tables; + The newline character sequence; + The compile time nested parentheses limit; + The maximum pattern length (in code units) that is allowed. + The additional options bits (see pcre2_set_compile_extra_options()) </pre> -or provide an external function for stack size checking. The option bits are: +The option bits are: <pre> PCRE2_ANCHORED Force pattern anchoring + PCRE2_ALLOW_EMPTY_CLASS Allow empty classes PCRE2_ALT_BSUX Alternative handling of \u, \U, and \x PCRE2_ALT_CIRCUMFLEX Alternative handling of ^ in multiline mode + PCRE2_ALT_VERBNAMES Process backslashes in verb names PCRE2_AUTO_CALLOUT Compile automatic callouts PCRE2_CASELESS Do caseless matching PCRE2_DOLLAR_ENDONLY $ not to match newline at end PCRE2_DOTALL . matches anything including NL PCRE2_DUPNAMES Allow duplicate names for subpatterns + PCRE2_ENDANCHORED Pattern can match only at end of subject PCRE2_EXTENDED Ignore white space and # comments PCRE2_FIRSTLINE Force matching to be before newline + PCRE2_LITERAL Pattern characters are all literal PCRE2_MATCH_UNSET_BACKREF Match unset back references PCRE2_MULTILINE ^ and $ match newlines within data PCRE2_NEVER_BACKSLASH_C Lock out the use of \C in patterns @@ -71,19 +79,21 @@ or provide an external function for stack size checking. The option bits are: (only relevant if PCRE2_UTF is set) PCRE2_UCP Use Unicode properties for \d, \w, etc. PCRE2_UNGREEDY Invert greediness of quantifiers + PCRE2_USE_OFFSET_LIMIT Enable offset limit for unanchored matching PCRE2_UTF Treat pattern and subjects as UTF strings </pre> -PCRE2 must be built with Unicode support in order to use PCRE2_UTF, PCRE2_UCP -and related options. +PCRE2 must be built with Unicode support (the default) in order to use +PCRE2_UTF, PCRE2_UCP and related options. </P> <P> 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. </P> <P> -There is a complete description of the PCRE2 native API in the +There is a complete description of the PCRE2 native API, with more detail on +each option, in the <a href="pcre2api.html"><b>pcre2api</b></a> -page and a description of the POSIX API in the +page, and a description of the POSIX API in the <a href="pcre2posix.html"><b>pcre2posix</b></a> page. <p> |