/[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 77 by nigel, Sat Feb 24 21:40:45 2007 UTC revision 87 by nigel, Sat Feb 24 21:41:21 2007 UTC
# Line 84  used to call PCRE. None of the other opt Line 84  used to call PCRE. None of the other opt
84  set.  set.
85  </P>  </P>
86  <P>  <P>
87    \fP-q\fP
88    Do not output the version number of <b>pcretest</b> at the start of execution.
89    </P>
90    <P>
91  <b>-t</b>  <b>-t</b>
92  Run each compile, study, and match many times with a timer, and output  Run each compile, study, and match many times with a timer, and output
93  resulting time per compile or match (in milliseconds). Do not set <b>-m</b> with  resulting time per compile or match (in milliseconds). Do not set <b>-m</b> with
# Line 291  recognized: Line 295  recognized:
295    \Gname     call pcre_get_named_substring() for substring "name" after a successful match (name termin-    \Gname     call pcre_get_named_substring() for substring "name" after a successful match (name termin-
296                 ated by next non-alphanumeric character)                 ated by next non-alphanumeric character)
297    \L         call pcre_get_substringlist() after a successful match    \L         call pcre_get_substringlist() after a successful match
298    \M         discover the minimum MATCH_LIMIT setting    \M         discover the minimum MATCH_LIMIT and
299                   MATCH_LIMIT_RECURSION settings
300    \N         pass the PCRE_NOTEMPTY option to <b>pcre_exec()</b>    \N         pass the PCRE_NOTEMPTY option to <b>pcre_exec()</b>
301    \Odd       set the size of the output vector passed to <b>pcre_exec()</b> to dd (any number of digits)    \Odd       set the size of the output vector passed to <b>pcre_exec()</b> to dd (any number of digits)
302    \P         pass the PCRE_PARTIAL option to <b>pcre_exec()</b> or <b>pcre_dfa_exec()</b>    \P         pass the PCRE_PARTIAL option to <b>pcre_exec()</b> or <b>pcre_dfa_exec()</b>
# Line 308  an empty line as data, since a real empt Line 313  an empty line as data, since a real empt
313  </P>  </P>
314  <P>  <P>
315  If \M is present, <b>pcretest</b> calls <b>pcre_exec()</b> several times, with  If \M is present, <b>pcretest</b> calls <b>pcre_exec()</b> several times, with
316  different values in the <i>match_limit</i> field of the <b>pcre_extra</b> data  different values in the <i>match_limit</i> and <i>match_limit_recursion</i>
317  structure, until it finds the minimum number that is needed for  fields of the <b>pcre_extra</b> data structure, until it finds the minimum
318  <b>pcre_exec()</b> to complete. This number is a measure of the amount of  numbers for each parameter that allow <b>pcre_exec()</b> to complete. The
319  recursion and backtracking that takes place, and checking it out can be  <i>match_limit</i> number is a measure of the amount of backtracking that takes
320  instructive. For most simple matches, the number is quite small, but for  place, and checking it out can be instructive. For most simple matches, the
321  patterns with very large numbers of matching possibilities, it can become large  number is quite small, but for patterns with very large numbers of matching
322  very quickly with increasing length of subject string.  possibilities, it can become large very quickly with increasing length of
323    subject string. The <i>match_limit_recursion</i> number is a measure of how much
324    stack (or, if PCRE is compiled with NO_RECURSE, how much heap) memory is needed
325    to complete the match attempt.
326  </P>  </P>
327  <P>  <P>
328  When \O is used, the value specified may be higher or lower than the size set  When \O is used, the value specified may be higher or lower than the size set
# Line 323  the call of pcre_exec() for the l Line 331  the call of pcre_exec() for the l
331  </P>  </P>
332  <P>  <P>
333  If the <b>/P</b> modifier was present on the pattern, causing the POSIX wrapper  If the <b>/P</b> modifier was present on the pattern, causing the POSIX wrapper
334  API to be used, only \B and \Z have any effect, causing REG_NOTBOL and  API to be used, the only option-setting sequences that have any effect are \B
335  REG_NOTEOL to be passed to <b>regexec()</b> respectively.  and \Z, causing REG_NOTBOL and REG_NOTEOL, respectively, to be passed to
336    <b>regexec()</b>.
337  </P>  </P>
338  <P>  <P>
339  The use of \x{hh...} to represent UTF-8 characters is not dependent on the use  The use of \x{hh...} to represent UTF-8 characters is not dependent on the use
# Line 572  University Computing Service, Line 581  University Computing Service,
581  Cambridge CB2 3QG, England.  Cambridge CB2 3QG, England.
582  </P>  </P>
583  <P>  <P>
584  Last updated: 28 February 2005  Last updated: 18 January 2006
585  <br>  <br>
586  Copyright &copy; 1997-2005 University of Cambridge.  Copyright &copy; 1997-2006 University of Cambridge.
587  <p>  <p>
588  Return to the <a href="index.html">PCRE index page</a>.  Return to the <a href="index.html">PCRE index page</a>.
589  </p>  </p>

Legend:
Removed from v.77  
changed lines
  Added in v.87

webmaster@exim.org
ViewVC Help
Powered by ViewVC 1.1.12