src/external/pcre2-10.32/doc/html/pcre2limits.html

   1 <html>
   2 <head>
   3 <title>pcre2limits specification</title>
   4 </head>
   5 <body bgcolor="#FFFFFF" text="#00005A" link="#0066FF" alink="#3399FF" vlink="#2222BB">
   6 <h1>pcre2limits man page</h1>
   7 <p>
   8 Return to the <a href="index.html">PCRE2 index page</a>.
   9 </p>
  10 <p>
  11 This page is part of the PCRE2 HTML documentation. It was generated
  12 automatically from the original man page. If there is any nonsense in it,
  13 please consult the man page, in case the conversion went wrong.
  14 <br>
  15 <br><b>
  16 SIZE AND OTHER LIMITATIONS
  17 </b><br>
  18 <P>
  19 There are some size limitations in PCRE2 but it is hoped that they will never
  20 in practice be relevant.
  21 </P>
  22 <P>
  23 The maximum size of a compiled pattern is approximately 64 thousand code units
  24 for the 8-bit and 16-bit libraries if PCRE2 is compiled with the default
  25 internal linkage size, which is 2 bytes for these libraries. If you want to
  26 process regular expressions that are truly enormous, you can compile PCRE2 with
  27 an internal linkage size of 3 or 4 (when building the 16-bit library, 3 is
  28 rounded up to 4). See the <b>README</b> file in the source distribution and the
  29 <a href="pcre2build.html"><b>pcre2build</b></a>
  30 documentation for details. In these cases the limit is substantially larger.
  31 However, the speed of execution is slower. In the 32-bit library, the internal
  32 linkage size is always 4.
  33 </P>
  34 <P>
  35 The maximum length of a source pattern string is essentially unlimited; it is
  36 the largest number a PCRE2_SIZE variable can hold. However, the program that
  37 calls <b>pcre2_compile()</b> can specify a smaller limit.
  38 </P>
  39 <P>
  40 The maximum length (in code units) of a subject string is one less than the
  41 largest number a PCRE2_SIZE variable can hold. PCRE2_SIZE is an unsigned
  42 integer type, usually defined as size_t. Its maximum value (that is
  43 ~(PCRE2_SIZE)0) is reserved as a special indicator for zero-terminated strings
  44 and unset offsets.
  45 </P>
  46 <P>
  47 All values in repeating quantifiers must be less than 65536.
  48 </P>
  49 <P>
  50 The maximum length of a lookbehind assertion is 65535 characters.
  51 </P>
  52 <P>
  53 There is no limit to the number of parenthesized subpatterns, but there can be
  54 no more than 65535 capturing subpatterns. There is, however, a limit to the
  55 depth of nesting of parenthesized subpatterns of all kinds. This is imposed in
  56 order to limit the amount of system stack used at compile time. The default
  57 limit can be specified when PCRE2 is built; if not, the default is set to 250.
  58 An application can change this limit by calling pcre2_set_parens_nest_limit()
  59 to set the limit in a compile context.
  60 </P>
  61 <P>
  62 The maximum length of name for a named subpattern is 32 code units, and the
  63 maximum number of named subpatterns is 10000.
  64 </P>
  65 <P>
  66 The maximum length of a name in a (*MARK), (*PRUNE), (*SKIP), or (*THEN) verb
  67 is 255 code units for the 8-bit library and 65535 code units for the 16-bit and
  68 32-bit libraries.
  69 </P>
  70 <P>
  71 The maximum length of a string argument to a callout is the largest number a
  72 32-bit unsigned integer can hold.
  73 </P>
  74 <br><b>
  75 AUTHOR
  76 </b><br>
  77 <P>
  78 Philip Hazel
  79 <br>
  80 University Computing Service
  81 <br>
  82 Cambridge, England.
  83 <br>
  84 </P>
  85 <br><b>
  86 REVISION
  87 </b><br>
  88 <P>
  89 Last updated: 30 March 2017
  90 <br>
  91 Copyright &copy; 1997-2017 University of Cambridge.
  92 <br>
  93 <p>
  94 Return to the <a href="index.html">PCRE2 index page</a>.
  95 </p>