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

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

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

revision 929 by ph10, Sat Jan 21 16:37:17 2012 UTC revision 930 by ph10, Fri Feb 24 12:05:54 2012 UTC
# Line 164  megabytes. Line 164  megabytes.
164  <P>  <P>
165  <b>-s</b> or <b>-s+</b>  <b>-s</b> or <b>-s+</b>
166  Behave as if each pattern has the <b>/S</b> modifier; in other words, force each  Behave as if each pattern has the <b>/S</b> modifier; in other words, force each
167  pattern to be studied. If <b>-s+</b> is used, the PCRE_STUDY_JIT_COMPILE flag is  pattern to be studied. If <b>-s+</b> is used, all the JIT compile options are
168  passed to <b>pcre[16]_study()</b>, causing just-in-time optimization to be set  passed to <b>pcre[16]_study()</b>, causing just-in-time optimization to be set
169  up if it is available. If the <b>/I</b> or <b>/D</b> option is present on a  up if it is available, for both full and partial matching. Specific JIT compile
170  pattern (requesting output about the compiled pattern), information about the  options can be selected by following <b>-s+</b> with a digit in the range 1 to
171  result of studying is not included when studying is caused only by <b>-s</b> and  7, which selects the JIT compile modes as follows:
172  neither <b>-i</b> nor <b>-d</b> is present on the command line. This behaviour  <pre>
173  means that the output from tests that are run with and without <b>-s</b> should    1  normal match only
174  be identical, except when options that output information about the actual    2  soft partial match only
175  running of a match are set.    3  normal match and soft partial match
176      4  hard partial match only
177      6  soft and hard partial match
178      7  all three modes (default)
179    </pre>
180    If <b>-s++</b> is used instead of <b>-s+</b> (with or without a following digit),
181    the text "(JIT)" is added to the first output line after a match or no match
182    when JIT-compiled code was actually used.
183    </P>
184    <P>
185    If the <b>/I</b> or <b>/D</b> option is present on a pattern (requesting output
186    about the compiled pattern), information about the result of studying is not
187    included when studying is caused only by <b>-s</b> and neither <b>-i</b> nor
188    <b>-d</b> is present on the command line. This behaviour means that the output
189    from tests that are run with and without <b>-s</b> should be identical, except
190    when options that output information about the actual running of a match are
191    set.
192  <br>  <br>
193  <br>  <br>
194  The <b>-M</b>, <b>-t</b>, and <b>-tm</b> options, which give information about  The <b>-M</b>, <b>-t</b>, and <b>-tm</b> options, which give information about
# Line 356  contains multiple copies of the same sub Line 372  contains multiple copies of the same sub
372  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
373  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
374  capture number. Note that this modifier must not immediately follow the /S  capture number. Note that this modifier must not immediately follow the /S
375  modifier because /S+ has another meaning.  modifier because /S+ and /S++ have other meanings.
376  </P>  </P>
377  <P>  <P>
378  The <b>/=</b> modifier requests that the values of all potential captured  The <b>/=</b> modifier requests that the values of all potential captured
# Line 435  files in a few cases where the output is Line 451  files in a few cases where the output is
451  </P>  </P>
452  <P>  <P>
453  If the <b>/S</b> modifier is immediately followed by a + character, the call to  If the <b>/S</b> modifier is immediately followed by a + character, the call to
454  <b>pcre[16]_study()</b> is made with the PCRE_STUDY_JIT_COMPILE option,  <b>pcre[16]_study()</b> is made with all the JIT study options, requesting
455  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
456  there is also a <b>/+</b> modifier; it must not be given immediately after  partial matching. If you want to restrict the JIT compiling modes, you can
457  <b>/S</b> because this will be misinterpreted. If JIT studying is successful, it  follow <b>/S+</b> with a digit in the range 1 to 7:
458  will automatically be used when <b>pcre[16]_exec()</b> is run, except when  <pre>
459  incompatible run-time options are specified. These include the partial matching    1  normal match only
460  options; a complete list is given in the    2  soft partial match only
461      3  normal match and soft partial match
462      4  hard partial match only
463      6  soft and hard partial match
464      7  all three modes (default)
465    </pre>
466    If <b>/S++</b> is used instead of <b>/S+</b> (with or without a following digit),
467    the text "(JIT)" is added to the first output line after a match or no match
468    when JIT-compiled code was actually used.
469    </P>
470    <P>
471    Note that there is also an independent <b>/+</b> modifier; it must not be given
472    immediately after <b>/S</b> or <b>/S+</b> because this will be misinterpreted.
473    </P>
474    <P>
475    If JIT studying is successful, the compiled JIT code will automatically be used
476    when <b>pcre[16]_exec()</b> is run, except when incompatible run-time options
477    are specified. For more details, see the
478  <a href="pcrejit.html"><b>pcrejit</b></a>  <a href="pcrejit.html"><b>pcrejit</b></a>
479  documentation. See also the <b>\J</b> escape sequence below for a way of  documentation. See also the <b>\J</b> escape sequence below for a way of
480  setting the size of the JIT stack.  setting the size of the JIT stack.
# Line 923  Cambridge CB2 3QH, England. Line 956  Cambridge CB2 3QH, England.
956  </P>  </P>
957  <br><a name="SEC16" href="#TOC1">REVISION</a><br>  <br><a name="SEC16" href="#TOC1">REVISION</a><br>
958  <P>  <P>
959  Last updated: 14 January 2012  Last updated: 21 February 2012
960  <br>  <br>
961  Copyright &copy; 1997-2012 University of Cambridge.  Copyright &copy; 1997-2012 University of Cambridge.
962  <br>  <br>

Legend:
Removed from v.929  
changed lines
  Added in v.930

  ViewVC Help
Powered by ViewVC 1.1.5