...

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

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


This page is part of the PCRE 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 PCRE but it is hoped that they will never in
practice be relevant.


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


All values in repeating quantifiers must be less than 65536.


There is no limit to the number of parenthesized subpatterns, but there can be
no more than 65535 capturing subpatterns. There is, however, 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 limit can
be specified when PCRE is built; the default is 250.


There is a limit to the number of forward references to subsequent subpatterns
of around 200,000. Repeated forward references with fixed upper limits, for
example, (?2){0,100} when subpattern number 2 is to the right, are included in
the count. There is no limit to the number of backward references.


The maximum length of name for a named subpattern is 32 characters, and the
maximum number of named subpatterns is 10000.


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


The maximum length of a subject string is the largest positive number that an
integer variable can hold. However, when using the traditional matching
function, PCRE uses recursion to handle subpatterns and indefinite repetition.
This means that the available stack space may limit the size of a subject
string that can be processed by certain patterns. For a discussion of stack
issues, see the
<a href="pcrestack.html">pcrestack</a>
documentation.

 
AUTHOR
 

Philip Hazel
 
University Computing Service
 
Cambridge CB2 3QH, England.
 

 
REVISION
 

Last updated: 05 November 2013
 
Copyright &copy; 1997-2013 University of Cambridge.
 

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

.	Edit
..	Edit
NON-AUTOTOOLS-BUILD.txt	Edit
README.txt	Edit
index.html	Edit
pcre-config.html	Edit
pcre.html	Edit
pcre16.html	Edit
pcre32.html	Edit
pcre_assign_jit_stack.html	Edit
pcre_compile.html	Edit
pcre_compile2.html	Edit
pcre_config.html	Edit
pcre_copy_named_substring.html	Edit
pcre_copy_substring.html	Edit
pcre_dfa_exec.html	Edit
pcre_exec.html	Edit
pcre_free_study.html	Edit
pcre_free_substring.html	Edit
pcre_free_substring_list.html	Edit
pcre_fullinfo.html	Edit
pcre_get_named_substring.html	Edit
pcre_get_stringnumber.html	Edit
pcre_get_stringtable_entries.html	Edit
pcre_get_substring.html	Edit
pcre_get_substring_list.html	Edit
pcre_jit_exec.html	Edit
pcre_jit_stack_alloc.html	Edit
pcre_jit_stack_free.html	Edit
pcre_maketables.html	Edit
pcre_pattern_to_host_byte_order.html	Edit
pcre_refcount.html	Edit
pcre_study.html	Edit
pcre_utf16_to_host_byte_order.html	Edit
pcre_utf32_to_host_byte_order.html	Edit
pcre_version.html	Edit
pcreapi.html	Edit
pcrebuild.html	Edit
pcrecallout.html	Edit
pcrecompat.html	Edit
pcrecpp.html	Edit
pcredemo.html	Edit
pcregrep.html	Edit
pcrejit.html	Edit
pcrelimits.html	Edit
pcrematching.html	Edit
pcrepartial.html	Edit
pcrepattern.html	Edit
pcreperform.html	Edit
pcreposix.html	Edit
pcreprecompile.html	Edit
pcresample.html	Edit
pcrestack.html	Edit
pcresyntax.html	Edit
pcretest.html	Edit
pcreunicode.html	Edit