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

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

Parent Directory | Revision Log | View Patch Patch

-revision 511 by ph10,
Mon Oct  5 10:59:35 2009 UTC
+revision 512 by ph10,
Tue Mar 30 11:11:52 2010 UTC
 Line 260 
 There are yet more modifiers for control
  operates.
  </P>
  <P>
+ The <b>/8</b> modifier causes <b>pcretest</b> to call PCRE with the PCRE_UTF8
+ option set. This turns on support for UTF-8 character handling in PCRE,
+ provided that it was compiled with this support enabled. This modifier also
+ causes any non-printing characters in output strings to be printed using the
+ \x{hh...} notation if they are valid UTF-8 sequences.
+ </P>
+ <P>
+ If the <b>/?</b> modifier is used with <b>/8</b>, it causes <b>pcretest</b> to
+ call <b>pcre_compile()</b> with the PCRE_NO_UTF8_CHECK option, to suppress the
+ checking of the string for UTF-8 validity.
+ </P>
+ <P>
  The <b>/+</b> modifier requests that as well as outputting the substring that
  matched the entire pattern, pcretest should in addition output the remainder of
  the subject string. This is useful for tests where the subject contains
-Line 274 
 use in the automatic test scripts; it en
+Line 286 
 use in the automatic test scripts; it en
  for different internal link sizes.
  </P>
  <P>
- The <b>/L</b> modifier must be followed directly by the name of a locale, for
- example,
- <pre>
-   /pattern/Lfr_FR
- </pre>
- For this reason, it must be the last modifier. The given locale is set,
- <b>pcre_maketables()</b> is called to build a set of character tables for the
- locale, and this is then passed to <b>pcre_compile()</b> when compiling the
- regular expression. Without an <b>/L</b> modifier, NULL is passed as the tables
- pointer; that is, <b>/L</b> applies only to the expression on which it appears.
- </P>
- <P>
- The <b>/I</b> modifier requests that <b>pcretest</b> output information about the
- compiled pattern (whether it is anchored, has a fixed first character, and
- so on). It does this by calling <b>pcre_fullinfo()</b> after compiling a
- pattern. If the pattern is studied, the results of that are also output.
- </P>
- <P>
  The <b>/D</b> modifier is a PCRE debugging feature, and is equivalent to
  <b>/BI</b>, that is, both the <b>/B</b> and the <b>/I</b> modifiers.
  </P>
-Line 305 
 available when the POSIX interface to PC
+Line 299 
 available when the POSIX interface to PC
  reloading compiled patterns below.
  </P>
  <P>
- The <b>/S</b> modifier causes <b>pcre_study()</b> to be called after the
+ The <b>/I</b> modifier requests that <b>pcretest</b> output information about the
- expression has been compiled, and the results used when the expression is
+ compiled pattern (whether it is anchored, has a fixed first character, and
- matched.
+ so on). It does this by calling <b>pcre_fullinfo()</b> after compiling a
+ pattern. If the pattern is studied, the results of that are also output.
+ </P>
+ <P>
+ The <b>/K</b> modifier requests <b>pcretest</b> to show names from backtracking
+ control verbs that are returned from calls to <b>pcre_exec()</b>. It causes
+ <b>pcretest</b> to create a <b>pcre_extra</b> block if one has not already been
+ created by a call to <b>pcre_study()</b>, and to set the PCRE_EXTRA_MARK flag
+ and the <b>mark</b> field within it, every time that <b>pcre_exec()</b> is
+ called. If the variable that the <b>mark</b> field points to is non-NULL for a
+ match, non-match, or partial match, <b>pcretest</b> prints the string to which
+ it points. For a match, this is shown on a line by itself, tagged with "MK:".
+ For a non-match it is added to the message.
+ </P>
+ <P>
+ The <b>/L</b> modifier must be followed directly by the name of a locale, for
+ example,
+ <pre>
+   /pattern/Lfr_FR
+ </pre>
+ For this reason, it must be the last modifier. The given locale is set,
+ <b>pcre_maketables()</b> is called to build a set of character tables for the
+ locale, and this is then passed to <b>pcre_compile()</b> when compiling the
+ regular expression. Without an <b>/L</b> modifier, NULL is passed as the tables
+ pointer; that is, <b>/L</b> applies only to the expression on which it appears.
  </P>
  <P>
  The <b>/M</b> modifier causes the size of memory block used to hold the compiled
-Line 321 
 present, and REG_NEWLINE is set if /m
+Line 339 
 present, and REG_NEWLINE is set if /m
  force PCRE_DOLLAR_ENDONLY always, and PCRE_DOTALL unless REG_NEWLINE is set.
  </P>
  <P>
- The <b>/8</b> modifier causes <b>pcretest</b> to call PCRE with the PCRE_UTF8
+ The <b>/S</b> modifier causes <b>pcre_study()</b> to be called after the
- option set. This turns on support for UTF-8 character handling in PCRE,
+ expression has been compiled, and the results used when the expression is
- provided that it was compiled with this support enabled. This modifier also
+ matched.
- causes any non-printing characters in output strings to be printed using the
- \x{hh...} notation if they are valid UTF-8 sequences.
- </P>
- <P>
- If the <b>/?</b> modifier is used with <b>/8</b>, it causes <b>pcretest</b> to
- call <b>pcre_compile()</b> with the PCRE_NO_UTF8_CHECK option, to suppress the
- checking of the string for UTF-8 validity.
  </P>
  <br><a name="SEC5" href="#TOC1">DATA LINES</a><br>
  <P>
-Line 709 
 Cambridge CB2 3QH, England.
+Line 720 
 Cambridge CB2 3QH, England.
  </P>
  <br><a name="SEC15" href="#TOC1">REVISION</a><br>
  <P>
- Last updated: 26 September 2009
+ Last updated: 26 March 2010
  <br>
- Copyright &copy; 1997-2009 University of Cambridge.
+ Copyright &copy; 1997-2010 University of Cambridge.
  <br>
  <p>
  Return to the <a href="index.html">PCRE index page</a>.

 Legend:



Removed from v.511
 


changed lines


 
Added in v.512
 Legend:



Removed from v.511
 


changed lines


 
Added in v.512
-Removed from v.511
+Added in v.512

webmaster@exim.org	ViewVC Help
Powered by ViewVC 1.1.12