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

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

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

revision 541 by ph10, Thu Jun 3 19:18:24 2010 UTC revision 542 by ph10, Tue Jun 15 08:49:47 2010 UTC
# Line 1443  sample program. Line 1443  sample program.
1443    PCRE_NO_START_OPTIMIZE    PCRE_NO_START_OPTIMIZE
1444  .sp  .sp
1445  There are a number of optimizations that \fBpcre_exec()\fP uses at the start of  There are a number of optimizations that \fBpcre_exec()\fP uses at the start of
1446  a match, in order to speed up the process. For example, if it is known that a  a match, in order to speed up the process. For example, if it is known that an
1447  match must start with a specific character, it searches the subject for that  unanchored match must start with a specific character, it searches the subject
1448  character, and fails immediately if it cannot find it, without actually running  for that character, and fails immediately if it cannot find it, without
1449  the main matching function. When callouts are in use, these optimizations can  actually running the main matching function. This means that a special item
1450  cause them to be skipped. This option disables the "start-up" optimizations,  such as (*COMMIT) at the start of a pattern is not considered until after a
1451  causing performance to suffer, but ensuring that the callouts do occur.  suitable starting point for the match has been found. When callouts are in use,
1452    these "start-up" optimizations can cause them to be skipped if the pattern is
1453    never actually used. The PCRE_NO_START_OPTIMIZE option disables the start-up
1454    optimizations, causing performance to suffer, but ensuring that the callouts do
1455    occur, and that items such as (*COMMIT) are considered at every possible
1456    starting position in the subject string.
1457  .sp  .sp
1458    PCRE_NO_UTF8_CHECK    PCRE_NO_UTF8_CHECK
1459  .sp  .sp
# Line 1995  Here is an example of a simple call to \ Line 2000  Here is an example of a simple call to \
2000  The unused bits of the \fIoptions\fP argument for \fBpcre_dfa_exec()\fP must be  The unused bits of the \fIoptions\fP argument for \fBpcre_dfa_exec()\fP must be
2001  zero. The only bits that may be set are PCRE_ANCHORED, PCRE_NEWLINE_\fIxxx\fP,  zero. The only bits that may be set are PCRE_ANCHORED, PCRE_NEWLINE_\fIxxx\fP,
2002  PCRE_NOTBOL, PCRE_NOTEOL, PCRE_NOTEMPTY, PCRE_NOTEMPTY_ATSTART,  PCRE_NOTBOL, PCRE_NOTEOL, PCRE_NOTEMPTY, PCRE_NOTEMPTY_ATSTART,
2003  PCRE_NO_UTF8_CHECK, PCRE_PARTIAL_HARD, PCRE_PARTIAL_SOFT, PCRE_DFA_SHORTEST,  PCRE_NO_UTF8_CHECK, PCRE_BSR_ANYCRLF, PCRE_BSR_UNICODE, PCRE_NO_START_OPTIMIZE,
2004  and PCRE_DFA_RESTART. All but the last four of these are exactly the same as  PCRE_PARTIAL_HARD, PCRE_PARTIAL_SOFT, PCRE_DFA_SHORTEST, and PCRE_DFA_RESTART.
2005  for \fBpcre_exec()\fP, so their description is not repeated here.  All but the last four of these are exactly the same as for \fBpcre_exec()\fP,
2006    so their description is not repeated here.
2007  .sp  .sp
2008    PCRE_PARTIAL_HARD    PCRE_PARTIAL_HARD
2009    PCRE_PARTIAL_SOFT    PCRE_PARTIAL_SOFT
# Line 2131  Cambridge CB2 3QH, England. Line 2137  Cambridge CB2 3QH, England.
2137  .rs  .rs
2138  .sp  .sp
2139  .nf  .nf
2140  Last updated: 01 June 2010  Last updated: 15 June 2010
2141  Copyright (c) 1997-2010 University of Cambridge.  Copyright (c) 1997-2010 University of Cambridge.
2142  .fi  .fi
Legend:
Removed from v.541  
changed lines
  Added in v.542
webmaster@exim.org
 ViewVC Help
Powered by ViewVC 1.1.12