--- embedaddon/pcre/doc/html/pcretest.html 2012/02/21 23:50:25 1.1.1.2 +++ embedaddon/pcre/doc/html/pcretest.html 2012/10/09 09:19:18 1.1.1.3 @@ -164,15 +164,31 @@ megabytes.
-s or -s+ Behave as if each pattern has the /S modifier; in other words, force each -pattern to be studied. If -s+ is used, the PCRE_STUDY_JIT_COMPILE flag is +pattern to be studied. If -s+ is used, all the JIT compile options are passed to pcre[16]_study(), causing just-in-time optimization to be set -up if it is available. If the /I or /D 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 -s and -neither -i nor -d is present on the command line. This behaviour -means that the output from tests that are run with and without -s should -be identical, except when options that output information about the actual -running of a match are set. +up if it is available, for both full and partial matching. Specific JIT compile +options can be selected by following -s+ with a digit in the range 1 to +7, which selects the JIT compile modes as follows: +
+ 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) ++If -s++ is used instead of -s+ (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. + +
+If the /I or /D 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 -s and neither -i nor
+-d is present on the command line. This behaviour means that the output
+from tests that are run with and without -s should be identical, except
+when options that output information about the actual running of a match are
+set.
The -M, -t, and -tm options, which give information about
@@ -356,7 +372,7 @@ contains multiple copies of the same substring. If 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
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.
The /= modifier requests that the values of all potential captured @@ -435,13 +451,30 @@ files in a few cases where the output is different whe
If the /S modifier is immediately followed by a + character, the call to -pcre[16]_study() is made with the PCRE_STUDY_JIT_COMPILE option, -requesting just-in-time optimization support if it is available. Note that -there is also a /+ modifier; it must not be given immediately after -/S because this will be misinterpreted. If JIT studying is successful, it -will automatically be used when pcre[16]_exec() is run, except when -incompatible run-time options are specified. These include the partial matching -options; a complete list is given in the +pcre[16]_study() is made with all the JIT study options, requesting +just-in-time optimization support if it is available, for both normal and +partial matching. If you want to restrict the JIT compiling modes, you can +follow /S+ with a digit in the range 1 to 7: +
+ 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) ++If /S++ is used instead of /S+ (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. + +
+Note that there is also an independent /+ modifier; it must not be given +immediately after /S or /S+ because this will be misinterpreted. +
++If JIT studying is successful, the compiled JIT code will automatically be used +when pcre[16]_exec() is run, except when incompatible run-time options +are specified. For more details, see the pcrejit documentation. See also the \J escape sequence below for a way of setting the size of the JIT stack. @@ -923,7 +956,7 @@ Cambridge CB2 3QH, England.
-Last updated: 14 January 2012
+Last updated: 21 February 2012
Copyright © 1997-2012 University of Cambridge.