...

<html>
<head>
<title>pcre2limits specification</title>
</head>
<body bgcolor="#FFFFFF" text="#00005A" link="#0066FF" alink="#3399FF" vlink="#2222BB">
<h1>pcre2limits man page</h1>

Return to the <a href="index.html">PCRE2 index page</a>.


This page is part of the PCRE2 HTML documentation. It was generated
automatically from the original man page. If there is any nonsense in it,
please consult the man page, in case the conversion went wrong.
 
 
SIZE AND OTHER LIMITATIONS
 

There are some size limitations in PCRE2 but it is hoped that they will never
in practice be relevant.


The maximum size of a compiled pattern is approximately 64 thousand code units
for the 8-bit and 16-bit libraries if PCRE2 is compiled with the default
internal linkage size, which is 2 bytes for these libraries. If you want to
process regular expressions that are truly enormous, you can compile PCRE2 with
an internal linkage size of 3 or 4 (when building the 16-bit library, 3 is
rounded up to 4). See the README file in the source distribution and the
<a href="pcre2build.html">pcre2build</a>
documentation for details. In these cases the limit is substantially larger.
However, the speed of execution is slower. In the 32-bit library, the internal
linkage size is always 4.


The maximum length of a source pattern string is essentially unlimited; it is
the largest number a PCRE2_SIZE variable can hold. However, the program that
calls pcre2_compile() can specify a smaller limit.


The maximum length (in code units) of a subject string is one less than the
largest number a PCRE2_SIZE variable can hold. PCRE2_SIZE is an unsigned
integer type, usually defined as size_t. Its maximum value (that is
~(PCRE2_SIZE)0) is reserved as a special indicator for zero-terminated strings
and unset offsets.


All values in repeating quantifiers must be less than 65536.


The maximum length of a lookbehind assertion is 65535 characters.


There is no limit to the number of parenthesized groups, but there can be no
more than 65535 capture groups, and there is a limit to the depth of nesting of
parenthesized subpatterns of all kinds. This is imposed in order to limit the
amount of system stack used at compile time. The default limit can be specified
when PCRE2 is built; if not, the default is set to 250. An application can
change this limit by calling pcre2_set_parens_nest_limit() to set the limit in
a compile context.


The maximum length of name for a named capture group is 32 code units, and the
maximum number of such groups is 10000.


The maximum length of a name in a (*MARK), (*PRUNE), (*SKIP), or (*THEN) verb
is 255 code units for the 8-bit library and 65535 code units for the 16-bit and
32-bit libraries.


The maximum length of a string argument to a callout is the largest number a
32-bit unsigned integer can hold.

 
AUTHOR
 

Philip Hazel
 
University Computing Service
 
Cambridge, England.
 

 
REVISION
 

Last updated: 02 February 2019
 
Copyright &copy; 1997-2019 University of Cambridge.
 

Return to the <a href="index.html">PCRE2 index page</a>.

.	Edit
..	Edit
NON-AUTOTOOLS-BUILD.txt	Edit
README.txt	Edit
index.html	Edit
pcre2-config.html	Edit
pcre2.html	Edit
pcre2_callout_enumerate.html	Edit
pcre2_code_copy.html	Edit
pcre2_code_copy_with_tables.html	Edit
pcre2_code_free.html	Edit
pcre2_compile.html	Edit
pcre2_compile_context_copy.html	Edit
pcre2_compile_context_create.html	Edit
pcre2_compile_context_free.html	Edit
pcre2_config.html	Edit
pcre2_convert_context_copy.html	Edit
pcre2_convert_context_create.html	Edit
pcre2_convert_context_free.html	Edit
pcre2_converted_pattern_free.html	Edit
pcre2_dfa_match.html	Edit
pcre2_general_context_copy.html	Edit
pcre2_general_context_create.html	Edit
pcre2_general_context_free.html	Edit
pcre2_get_error_message.html	Edit
pcre2_get_mark.html	Edit
pcre2_get_match_data_size.html	Edit
pcre2_get_ovector_count.html	Edit
pcre2_get_ovector_pointer.html	Edit
pcre2_get_startchar.html	Edit
pcre2_jit_compile.html	Edit
pcre2_jit_free_unused_memory.html	Edit
pcre2_jit_match.html	Edit
pcre2_jit_stack_assign.html	Edit
pcre2_jit_stack_create.html	Edit
pcre2_jit_stack_free.html	Edit
pcre2_maketables.html	Edit
pcre2_maketables_free.html	Edit
pcre2_match.html	Edit
pcre2_match_context_copy.html	Edit
pcre2_match_context_create.html	Edit
pcre2_match_context_free.html	Edit
pcre2_match_data_create.html	Edit
pcre2_match_data_create_from_pattern.html	Edit
pcre2_match_data_free.html	Edit
pcre2_pattern_convert.html	Edit
pcre2_pattern_info.html	Edit
pcre2_serialize_decode.html	Edit
pcre2_serialize_encode.html	Edit
pcre2_serialize_free.html	Edit
pcre2_serialize_get_number_of_codes.html	Edit
pcre2_set_bsr.html	Edit
pcre2_set_callout.html	Edit
pcre2_set_character_tables.html	Edit
pcre2_set_compile_extra_options.html	Edit
pcre2_set_compile_recursion_guard.html	Edit
pcre2_set_depth_limit.html	Edit
pcre2_set_glob_escape.html	Edit
pcre2_set_glob_separator.html	Edit
pcre2_set_heap_limit.html	Edit
pcre2_set_match_limit.html	Edit
pcre2_set_max_pattern_length.html	Edit
pcre2_set_newline.html	Edit
pcre2_set_offset_limit.html	Edit
pcre2_set_parens_nest_limit.html	Edit
pcre2_set_recursion_limit.html	Edit
pcre2_set_recursion_memory_management.html	Edit
pcre2_set_substitute_callout.html	Edit
pcre2_substitute.html	Edit
pcre2_substring_copy_byname.html	Edit
pcre2_substring_copy_bynumber.html	Edit
pcre2_substring_free.html	Edit
pcre2_substring_get_byname.html	Edit
pcre2_substring_get_bynumber.html	Edit
pcre2_substring_length_byname.html	Edit
pcre2_substring_length_bynumber.html	Edit
pcre2_substring_list_free.html	Edit
pcre2_substring_list_get.html	Edit
pcre2_substring_nametable_scan.html	Edit
pcre2_substring_number_from_name.html	Edit
pcre2api.html	Edit
pcre2build.html	Edit
pcre2callout.html	Edit
pcre2compat.html	Edit
pcre2convert.html	Edit
pcre2demo.html	Edit
pcre2grep.html	Edit
pcre2jit.html	Edit
pcre2limits.html	Edit
pcre2matching.html	Edit
pcre2partial.html	Edit
pcre2pattern.html	Edit
pcre2perform.html	Edit
pcre2posix.html	Edit
pcre2sample.html	Edit
pcre2serialize.html	Edit
pcre2syntax.html	Edit
pcre2test.html	Edit
pcre2unicode.html	Edit