/[pcre]/code/trunk/doc/html/pcreapi.html
ViewVC logotype

Diff of /code/trunk/doc/html/pcreapi.html

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 391 by ph10, Mon Aug 25 18:28:05 2008 UTC revision 392 by ph10, Tue Mar 17 21:30:30 2009 UTC
# Line 333  properties is available; otherwise it is Line 333  properties is available; otherwise it is
333  </pre>  </pre>
334  The output is an integer whose value specifies the default character sequence  The output is an integer whose value specifies the default character sequence
335  that is recognized as meaning "newline". The four values that are supported  that is recognized as meaning "newline". The four values that are supported
336  are: 10 for LF, 13 for CR, 3338 for CRLF, -2 for ANYCRLF, and -1 for ANY. The  are: 10 for LF, 13 for CR, 3338 for CRLF, -2 for ANYCRLF, and -1 for ANY.
337  default should normally be the standard sequence for your operating system.  Though they are derived from ASCII, the same values are returned in EBCDIC
338    environments. The default should normally correspond to the standard sequence
339    for your operating system.
340  <pre>  <pre>
341    PCRE_CONFIG_BSR    PCRE_CONFIG_BSR
342  </pre>  </pre>
# Line 361  documentation. Line 363  documentation.
363  <pre>  <pre>
364    PCRE_CONFIG_MATCH_LIMIT    PCRE_CONFIG_MATCH_LIMIT
365  </pre>  </pre>
366  The output is an integer that gives the default limit for the number of  The output is a long integer that gives the default limit for the number of
367  internal matching function calls in a <b>pcre_exec()</b> execution. Further  internal matching function calls in a <b>pcre_exec()</b> execution. Further
368  details are given with <b>pcre_exec()</b> below.  details are given with <b>pcre_exec()</b> below.
369  <pre>  <pre>
370    PCRE_CONFIG_MATCH_LIMIT_RECURSION    PCRE_CONFIG_MATCH_LIMIT_RECURSION
371  </pre>  </pre>
372  The output is an integer that gives the default limit for the depth of  The output is a long integer that gives the default limit for the depth of
373  recursion when calling the internal matching function in a <b>pcre_exec()</b>  recursion when calling the internal matching function in a <b>pcre_exec()</b>
374  execution. Further details are given with <b>pcre_exec()</b> below.  execution. Further details are given with <b>pcre_exec()</b> below.
375  <pre>  <pre>
# Line 1242  Option bits for pcre_exec() Line 1244  Option bits for pcre_exec()
1244  <P>  <P>
1245  The unused bits of the <i>options</i> argument for <b>pcre_exec()</b> must be  The unused bits of the <i>options</i> argument for <b>pcre_exec()</b> must be
1246  zero. The only bits that may be set are PCRE_ANCHORED, PCRE_NEWLINE_<i>xxx</i>,  zero. The only bits that may be set are PCRE_ANCHORED, PCRE_NEWLINE_<i>xxx</i>,
1247  PCRE_NOTBOL, PCRE_NOTEOL, PCRE_NOTEMPTY, PCRE_NO_UTF8_CHECK and PCRE_PARTIAL.  PCRE_NOTBOL, PCRE_NOTEOL, PCRE_NOTEMPTY, PCRE_NO_START_OPTIMIZE,
1248    PCRE_NO_UTF8_CHECK and PCRE_PARTIAL.
1249  <pre>  <pre>
1250    PCRE_ANCHORED    PCRE_ANCHORED
1251  </pre>  </pre>
# Line 1334  PCRE_NOTEMPTY and PCRE_ANCHORED, and the Line 1337  PCRE_NOTEMPTY and PCRE_ANCHORED, and the
1337  starting offset (see below) and trying an ordinary match again. There is some  starting offset (see below) and trying an ordinary match again. There is some
1338  code that demonstrates how to do this in the <i>pcredemo.c</i> sample program.  code that demonstrates how to do this in the <i>pcredemo.c</i> sample program.
1339  <pre>  <pre>
1340      PCRE_NO_START_OPTIMIZE
1341    </pre>
1342    There are a number of optimizations that <b>pcre_exec()</b> uses at the start of
1343    a match, in order to speed up the process. For example, if it is known that a
1344    match must start with a specific character, it searches the subject for that
1345    character, and fails immediately if it cannot find it, without actually running
1346    the main matching function. When callouts are in use, these optimizations can
1347    cause them to be skipped. This option disables the "start-up" optimizations,
1348    causing performance to suffer, but ensuring that the callouts do occur.
1349    <pre>
1350    PCRE_NO_UTF8_CHECK    PCRE_NO_UTF8_CHECK
1351  </pre>  </pre>
1352  When PCRE_UTF8 is set at compile time, the validity of the subject as a UTF-8  When PCRE_UTF8 is set at compile time, the validity of the subject as a UTF-8
# Line 1743  then call pcre_copy_substring() o Line 1756  then call pcre_copy_substring() o
1756  appropriate. <b>NOTE:</b> If PCRE_DUPNAMES is set and there are duplicate names,  appropriate. <b>NOTE:</b> If PCRE_DUPNAMES is set and there are duplicate names,
1757  the behaviour may not be what you want (see the next section).  the behaviour may not be what you want (see the next section).
1758  </P>  </P>
1759    <P>
1760    <b>Warning:</b> If the pattern uses the "(?|" feature to set up multiple
1761    subpatterns with the same number, you cannot use names to distinguish them,
1762    because names are not included in the compiled code. The matching process uses
1763    only numbers.
1764    </P>
1765  <br><a name="SEC17" href="#TOC1">DUPLICATE SUBPATTERN NAMES</a><br>  <br><a name="SEC17" href="#TOC1">DUPLICATE SUBPATTERN NAMES</a><br>
1766  <P>  <P>
1767  <b>int pcre_get_stringtable_entries(const pcre *<i>code</i>,</b>  <b>int pcre_get_stringtable_entries(const pcre *<i>code</i>,</b>
# Line 1976  Cambridge CB2 3QH, England. Line 1995  Cambridge CB2 3QH, England.
1995  </P>  </P>
1996  <br><a name="SEC22" href="#TOC1">REVISION</a><br>  <br><a name="SEC22" href="#TOC1">REVISION</a><br>
1997  <P>  <P>
1998  Last updated: 24 August 2008  Last updated: 17 March 2009
1999  <br>  <br>
2000  Copyright &copy; 1997-2008 University of Cambridge.  Copyright &copy; 1997-2009 University of Cambridge.
2001  <br>  <br>
2002  <p>  <p>
2003  Return to the <a href="index.html">PCRE index page</a>.  Return to the <a href="index.html">PCRE index page</a>.
Legend:
Removed from v.391  
changed lines
  Added in v.392
webmaster@exim.org
 ViewVC Help
Powered by ViewVC 1.1.12