/[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 975 by ph10, Sat Jun 2 11:03:06 2012 UTC revision 1022 by ph10, Tue Aug 28 12:28:15 2012 UTC
# Line 1  Line 1 
1  .TH PCRETEST 1 "21 February 2012" "PCRE 8.31"  .TH PCRETEST 1 "28 August 2012" "PCRE 8.32"
2  .SH NAME  .SH NAME
3  pcretest - a program for testing Perl-compatible regular expressions.  pcretest - a program for testing Perl-compatible regular expressions.
4  .SH SYNOPSIS  .SH SYNOPSIS
# Line 22  and Line 22  and
22  .\" HREF  .\" HREF
23  \fBpcre16\fP  \fBpcre16\fP
24  .\"  .\"
25  documentation. The input for \fBpcretest\fP is a sequence of regular expression  documentation.
26  patterns and strings to be matched, as described below. The output shows the  .P
27  result of each match. Options on the command line and the patterns control PCRE  The input for \fBpcretest\fP is a sequence of regular expression patterns and
28  options and exactly what is output.  strings to be matched, as described below. The output shows the result of each
29    match. Options on the command line and the patterns control PCRE options and
30    exactly what is output.
31    .P
32    As PCRE has evolved, it has acquired many different features, and as a result,
33    \fBpcretest\fP now has rather a lot of obscure options for testing every
34    possible feature. Some of these options are specifically designed for use in
35    conjunction with the test script and data files that are distributed as part of
36    PCRE, and are unlikely to be of use otherwise. They are all documented here,
37    but without much justification.
38  .  .
39  .  .
40  .SH "PCRE's 8-BIT and 16-BIT LIBRARIES"  .SH "PCRE's 8-BIT and 16-BIT LIBRARIES"
# Line 145  options can be selected by following \fB Line 154  options can be selected by following \fB
154  If \fB-s++\fP is used instead of \fB-s+\fP (with or without a following digit),  If \fB-s++\fP is used instead of \fB-s+\fP (with or without a following digit),
155  the text "(JIT)" is added to the first output line after a match or no match  the text "(JIT)" is added to the first output line after a match or no match
156  when JIT-compiled code was actually used.  when JIT-compiled code was actually used.
157  .P  .sp
158    Note that there are pattern options that can override \fB-s\fP, either
159    specifying no studying at all, or suppressing JIT compilation.
160    .sp
161  If the \fB/I\fP or \fB/D\fP option is present on a pattern (requesting output  If the \fB/I\fP or \fB/D\fP option is present on a pattern (requesting output
162  about the compiled pattern), information about the result of studying is not  about the compiled pattern), information about the result of studying is not
163  included when studying is caused only by \fB-s\fP and neither \fB-i\fP nor  included when studying is caused only by \fB-s\fP and neither \fB-i\fP nor
# Line 391  the compiled pattern to be output. This Line 403  the compiled pattern to be output. This
403  successfully studied with the PCRE_STUDY_JIT_COMPILE option, the size of the  successfully studied with the PCRE_STUDY_JIT_COMPILE option, the size of the
404  JIT compiled code is also output.  JIT compiled code is also output.
405  .P  .P
406  If the \fB/S\fP modifier appears once, it causes \fBpcre[16]_study()\fP to be  The \fB/S\fP modifier causes \fBpcre[16]_study()\fP to be called after the
407  called after the expression has been compiled, and the results used when the  expression has been compiled, and the results used when the expression is
408  expression is matched. If \fB/S\fP appears twice, it suppresses studying, even  matched. There are a number of qualifying characters that may follow \fB/S\fP.
409    They may appear in any order.
410    .P
411    If \fBS\fP is followed by an exclamation mark, \fBpcre[16]_study()\fP is called
412    with the PCRE_STUDY_EXTRA_NEEDED option, causing it always to return a
413    \fBpcre_extra\fP block, even when studying discovers no useful information.
414    .P
415    If \fB/S\fP is followed by a second S character, it suppresses studying, even
416  if it was requested externally by the \fB-s\fP command line option. This makes  if it was requested externally by the \fB-s\fP command line option. This makes
417  it possible to specify that certain patterns are always studied, and others are  it possible to specify that certain patterns are always studied, and others are
418  never studied, independently of \fB-s\fP. This feature is used in the test  never studied, independently of \fB-s\fP. This feature is used in the test
419  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.
420  .P  .P
421  If the \fB/S\fP modifier is immediately followed by a + character, the call to  If the \fB/S\fP modifier is followed by a + character, the call to
422  \fBpcre[16]_study()\fP is made with all the JIT study options, requesting  \fBpcre[16]_study()\fP is made with all the JIT study options, requesting
423  just-in-time optimization support if it is available, for both normal and  just-in-time optimization support if it is available, for both normal and
424  partial matching. If you want to restrict the JIT compiling modes, you can  partial matching. If you want to restrict the JIT compiling modes, you can
# Line 428  are specified. For more details, see the Line 447  are specified. For more details, see the
447  documentation. See also the \fB\eJ\fP escape sequence below for a way of  documentation. See also the \fB\eJ\fP escape sequence below for a way of
448  setting the size of the JIT stack.  setting the size of the JIT stack.
449  .P  .P
450    Finally, if \fB/S\fP is followed by a minus character, JIT compilation is
451    suppressed, even if it was requested externally by the \fB-s\fP command line
452    option. This makes it possible to specify that JIT is never to be used for
453    certain patterns.
454    .P
455  The \fB/T\fP modifier must be followed by a single digit. It causes a specific  The \fB/T\fP modifier must be followed by a single digit. It causes a specific
456  set of built-in character tables to be passed to \fBpcre[16]_compile()\fP. It  set of built-in character tables to be passed to \fBpcre[16]_compile()\fP. It
457  is used in the standard PCRE tests to check behaviour with different character  is used in the standard PCRE tests to check behaviour with different character
# Line 966  Cambridge CB2 3QH, England. Line 990  Cambridge CB2 3QH, England.
990  .rs  .rs
991  .sp  .sp
992  .nf  .nf
993  Last updated: 21 February 2012  Last updated: 28 August 2012
994  Copyright (c) 1997-2012 University of Cambridge.  Copyright (c) 1997-2012 University of Cambridge.
995  .fi  .fi

Legend:
Removed from v.975  
changed lines
  Added in v.1022

  ViewVC Help
Powered by ViewVC 1.1.5