version 1.1.1.2, 2012/02/21 23:50:25
|
version 1.1.1.3, 2012/10/09 09:19:17
|
Line 1
|
Line 1
|
.TH PCRETEST 1 | .TH PCRETEST 1 "21 February 2012" "PCRE 8.31" |
.SH NAME |
.SH NAME |
pcretest - a program for testing Perl-compatible regular expressions. |
pcretest - a program for testing Perl-compatible regular expressions. |
.SH SYNOPSIS |
.SH SYNOPSIS |
Line 129 megabytes.
|
Line 129 megabytes.
|
.TP 10 |
.TP 10 |
\fB-s\fP or \fB-s+\fP |
\fB-s\fP or \fB-s+\fP |
Behave as if each pattern has the \fB/S\fP modifier; in other words, force each |
Behave as if each pattern has the \fB/S\fP modifier; in other words, force each |
pattern to be studied. If \fB-s+\fP is used, the PCRE_STUDY_JIT_COMPILE flag is | pattern to be studied. If \fB-s+\fP is used, all the JIT compile options are |
passed to \fBpcre[16]_study()\fP, causing just-in-time optimization to be set |
passed to \fBpcre[16]_study()\fP, causing just-in-time optimization to be set |
up if it is available. If the \fB/I\fP or \fB/D\fP option is present on a | up if it is available, for both full and partial matching. Specific JIT compile |
pattern (requesting output about the compiled pattern), information about the | options can be selected by following \fB-s+\fP with a digit in the range 1 to |
result of studying is not included when studying is caused only by \fB-s\fP and | 7, which selects the JIT compile modes as follows: |
neither \fB-i\fP nor \fB-d\fP is present on the command line. This behaviour | |
means that the output from tests that are run with and without \fB-s\fP should | |
be identical, except when options that output information about the actual | |
running of a match are set. | |
.sp |
.sp |
|
1 normal match only |
|
2 soft partial match only |
|
3 normal match and soft partial match |
|
4 hard partial match only |
|
6 soft and hard partial match |
|
7 all three modes (default) |
|
.sp |
|
If \fB-s++\fP is used instead of \fB-s+\fP (with or without a following digit), |
|
the text "(JIT)" is added to the first output line after a match or no match |
|
when JIT-compiled code was actually used. |
|
.P |
|
If the \fB/I\fP or \fB/D\fP option is present on a pattern (requesting output |
|
about the compiled pattern), information about the result of studying is not |
|
included when studying is caused only by \fB-s\fP and neither \fB-i\fP nor |
|
\fB-d\fP is present on the command line. This behaviour means that the output |
|
from tests that are run with and without \fB-s\fP should be identical, except |
|
when options that output information about the actual running of a match are |
|
set. |
|
.sp |
The \fB-M\fP, \fB-t\fP, and \fB-tm\fP options, which give information about |
The \fB-M\fP, \fB-t\fP, and \fB-tm\fP options, which give information about |
resources used, are likely to produce different output with and without |
resources used, are likely to produce different output with and without |
\fB-s\fP. Output may also differ if the \fB/C\fP option is present on an |
\fB-s\fP. Output may also differ if the \fB/C\fP option is present on an |
Line 316 contains multiple copies of the same substring. If the
|
Line 331 contains multiple copies of the same substring. If the
|
twice, the same action is taken for captured substrings. In each case the |
twice, the same action is taken for captured substrings. In each case the |
remainder is output on the following line with a plus character following the |
remainder is output on the following line with a plus character following the |
capture number. Note that this modifier must not immediately follow the /S |
capture number. Note that this modifier must not immediately follow the /S |
modifier because /S+ has another meaning. | modifier because /S+ and /S++ have other meanings. |
.P |
.P |
The \fB/=\fP modifier requests that the values of all potential captured |
The \fB/=\fP modifier requests that the values of all potential captured |
parentheses be output after a match. By default, only those up to the highest |
parentheses be output after a match. By default, only those up to the highest |
Line 385 never studied, independently of \fB-s\fP. This feature
|
Line 400 never studied, independently of \fB-s\fP. This feature
|
files in a few cases where the output is different when the pattern is studied. |
files in a few cases where the output is different when the pattern is studied. |
.P |
.P |
If the \fB/S\fP modifier is immediately followed by a + character, the call to |
If the \fB/S\fP modifier is immediately followed by a + character, the call to |
\fBpcre[16]_study()\fP is made with the PCRE_STUDY_JIT_COMPILE option, | \fBpcre[16]_study()\fP is made with all the JIT study options, requesting |
requesting just-in-time optimization support if it is available. Note that | just-in-time optimization support if it is available, for both normal and |
there is also a \fB/+\fP modifier; it must not be given immediately after | partial matching. If you want to restrict the JIT compiling modes, you can |
\fB/S\fP because this will be misinterpreted. If JIT studying is successful, it | follow \fB/S+\fP with a digit in the range 1 to 7: |
will automatically be used when \fBpcre[16]_exec()\fP is run, except when | .sp |
incompatible run-time options are specified. These include the partial matching | 1 normal match only |
options; a complete list is given in the | 2 soft partial match only |
| 3 normal match and soft partial match |
| 4 hard partial match only |
| 6 soft and hard partial match |
| 7 all three modes (default) |
| .sp |
| If \fB/S++\fP is used instead of \fB/S+\fP (with or without a following digit), |
| the text "(JIT)" is added to the first output line after a match or no match |
| when JIT-compiled code was actually used. |
| .P |
| Note that there is also an independent \fB/+\fP modifier; it must not be given |
| immediately after \fB/S\fP or \fB/S+\fP because this will be misinterpreted. |
| .P |
| If JIT studying is successful, the compiled JIT code will automatically be used |
| when \fBpcre[16]_exec()\fP is run, except when incompatible run-time options |
| are specified. For more details, see the |
.\" HREF |
.\" HREF |
\fBpcrejit\fP |
\fBpcrejit\fP |
.\" |
.\" |
Line 936 Cambridge CB2 3QH, England.
|
Line 966 Cambridge CB2 3QH, England.
|
.rs |
.rs |
.sp |
.sp |
.nf |
.nf |
Last updated: 14 January 2012 | Last updated: 21 February 2012 |
Copyright (c) 1997-2012 University of Cambridge. |
Copyright (c) 1997-2012 University of Cambridge. |
.fi |
.fi |