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

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

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 59  Behave as if each regex has the \fB/P\fP Line 59  Behave as if each regex has the \fB/P\fP
59  used to call PCRE. None of the other options has any effect when \fB-p\fP is  used to call PCRE. None of the other options has any effect when \fB-p\fP is
60  set.  set.
61  .TP 10  .TP 10
62    \fP-q\fP
63    Do not output the version number of \fBpcretest\fP at the start of execution.
64    .TP 10
65  \fB-t\fP  \fB-t\fP
66  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
67  resulting time per compile or match (in milliseconds). Do not set \fB-m\fP with  resulting time per compile or match (in milliseconds). Do not set \fB-m\fP with
# Line 276  recognized: Line 279  recognized:
279  .\" JOIN  .\" JOIN
280    \eL         call pcre_get_substringlist() after a    \eL         call pcre_get_substringlist() after a
281                 successful match                 successful match
282    \eM         discover the minimum MATCH_LIMIT setting    \eM         discover the minimum MATCH_LIMIT and
283                   MATCH_LIMIT_RECURSION settings
284    \eN         pass the PCRE_NOTEMPTY option to \fBpcre_exec()\fP    \eN         pass the PCRE_NOTEMPTY option to \fBpcre_exec()\fP
285  .\" JOIN  .\" JOIN
286    \eOdd       set the size of the output vector passed to    \eOdd       set the size of the output vector passed to
# Line 298  very last character is a backslash, it i Line 302  very last character is a backslash, it i
302  an empty line as data, since a real empty line terminates the data input.  an empty line as data, since a real empty line terminates the data input.
303  .P  .P
304  If \eM is present, \fBpcretest\fP calls \fBpcre_exec()\fP several times, with  If \eM is present, \fBpcretest\fP calls \fBpcre_exec()\fP several times, with
305  different values in the \fImatch_limit\fP field of the \fBpcre_extra\fP data  different values in the \fImatch_limit\fP and \fImatch_limit_recursion\fP
306  structure, until it finds the minimum number that is needed for  fields of the \fBpcre_extra\fP data structure, until it finds the minimum
307  \fBpcre_exec()\fP to complete. This number is a measure of the amount of  numbers for each parameter that allow \fBpcre_exec()\fP to complete. The
308  recursion and backtracking that takes place, and checking it out can be  \fImatch_limit\fP number is a measure of the amount of backtracking that takes
309  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
310  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
311  very quickly with increasing length of subject string.  possibilities, it can become large very quickly with increasing length of
312    subject string. The \fImatch_limit_recursion\fP number is a measure of how much
313    stack (or, if PCRE is compiled with NO_RECURSE, how much heap) memory is needed
314    to complete the match attempt.
315  .P  .P
316  When \eO is used, the value specified may be higher or lower than the size set  When \eO is used, the value specified may be higher or lower than the size set
317  by the \fB-O\fP command line option (or defaulted to 45); \eO applies only to  by the \fB-O\fP command line option (or defaulted to 45); \eO applies only to
318  the call of \fBpcre_exec()\fP for the line in which it appears.  the call of \fBpcre_exec()\fP for the line in which it appears.
319  .P  .P
320  If the \fB/P\fP modifier was present on the pattern, causing the POSIX wrapper  If the \fB/P\fP modifier was present on the pattern, causing the POSIX wrapper
321  API to be used, only \eB and \eZ have any effect, causing REG_NOTBOL and  API to be used, the only option-setting sequences that have any effect are \eB
322  REG_NOTEOL to be passed to \fBregexec()\fP respectively.  and \eZ, causing REG_NOTBOL and REG_NOTEOL, respectively, to be passed to
323    \fBregexec()\fP.
324  .P  .P
325  The use of \ex{hh...} to represent UTF-8 characters is not dependent on the use  The use of \ex{hh...} to represent UTF-8 characters is not dependent on the use
326  of the \fB/8\fP modifier on the pattern. It is recognized always. There may be  of the \fB/8\fP modifier on the pattern. It is recognized always. There may be
# Line 568  University Computing Service, Line 576  University Computing Service,
576  Cambridge CB2 3QG, England.  Cambridge CB2 3QG, England.
577  .P  .P
578  .in 0  .in 0
579  Last updated: 28 February 2005  Last updated: 18 January 2006
580  .br  .br
581  Copyright (c) 1997-2005 University of Cambridge.  Copyright (c) 1997-2006 University of Cambridge.
Legend:
Removed from v.77  
changed lines
  Added in v.87
  ViewVC Help
Powered by ViewVC 1.1.5