| 428 |
documentation). For those options that can be different in different parts of |
documentation). For those options that can be different in different parts of |
| 429 |
the pattern, the contents of the \fIoptions\fP argument specifies their |
the pattern, the contents of the \fIoptions\fP argument specifies their |
| 430 |
settings at the start of compilation and execution. The PCRE_ANCHORED, |
settings at the start of compilation and execution. The PCRE_ANCHORED, |
| 431 |
PCRE_BSR_\fIxxx\fP, and PCRE_NEWLINE_\fIxxx\fP options can be set at the time |
PCRE_BSR_\fIxxx\fP, PCRE_NEWLINE_\fIxxx\fP, PCRE_NO_UTF8_CHECK, and |
| 432 |
of matching as well as at compile time. |
PCRE_NO_START_OPT options can be set at the time of matching as well as at |
| 433 |
|
compile time. |
| 434 |
.P |
.P |
| 435 |
If \fIerrptr\fP is NULL, \fBpcre_compile()\fP returns NULL immediately. |
If \fIerrptr\fP is NULL, \fBpcre_compile()\fP returns NULL immediately. |
| 436 |
Otherwise, if compilation of a pattern fails, \fBpcre_compile()\fP returns |
Otherwise, if compilation of a pattern fails, \fBpcre_compile()\fP returns |
| 659 |
they acquire numbers in the usual way). There is no equivalent of this option |
they acquire numbers in the usual way). There is no equivalent of this option |
| 660 |
in Perl. |
in Perl. |
| 661 |
.sp |
.sp |
| 662 |
|
NO_START_OPTIMIZE |
| 663 |
|
.sp |
| 664 |
|
This is an option that acts at matching time; that is, it is really an option |
| 665 |
|
for \fBpcre_exec()\fP or \fBpcre_dfa_exec()\fP. If it is set at compile time, |
| 666 |
|
it is remembered with the compiled pattern and assumed at matching time. For |
| 667 |
|
details see the discussion of PCRE_NO_START_OPTIMIZE |
| 668 |
|
.\" HTML <a href="#execoptions"> |
| 669 |
|
.\" </a> |
| 670 |
|
below. |
| 671 |
|
.\" |
| 672 |
|
.sp |
| 673 |
PCRE_UCP |
PCRE_UCP |
| 674 |
.sp |
.sp |
| 675 |
This option changes the way PCRE processes \eB, \eb, \eD, \ed, \eS, \es, \eW, |
This option changes the way PCRE processes \eB, \eb, \eD, \ed, \eS, \es, \eW, |
| 1499 |
The PCRE_NO_START_OPTIMIZE option disables the start-up optimizations, possibly |
The PCRE_NO_START_OPTIMIZE option disables the start-up optimizations, possibly |
| 1500 |
causing performance to suffer, but ensuring that in cases where the result is |
causing performance to suffer, but ensuring that in cases where the result is |
| 1501 |
"no match", the callouts do occur, and that items such as (*COMMIT) and (*MARK) |
"no match", the callouts do occur, and that items such as (*COMMIT) and (*MARK) |
| 1502 |
are considered at every possible starting position in the subject string. |
are considered at every possible starting position in the subject string. If |
| 1503 |
|
PCRE_NO_START_OPTIMIZE is set at compile time, it cannot be unset at matching |
| 1504 |
|
time. |
| 1505 |
|
.P |
| 1506 |
Setting PCRE_NO_START_OPTIMIZE can change the outcome of a matching operation. |
Setting PCRE_NO_START_OPTIMIZE can change the outcome of a matching operation. |
| 1507 |
Consider the pattern |
Consider the pattern |
| 1508 |
.sp |
.sp |
| 2267 |
.rs |
.rs |
| 2268 |
.sp |
.sp |
| 2269 |
.nf |
.nf |
| 2270 |
Last updated: 13 November 2010 |
Last updated: 21 November 2010 |
| 2271 |
Copyright (c) 1997-2010 University of Cambridge. |
Copyright (c) 1997-2010 University of Cambridge. |
| 2272 |
.fi |
.fi |