Mercurial Mercurial > oss > FCL > sf > os > fshell / annotate
summary | shortlog | changelog | graph | tags | bookmarks | branches | files | changeset | file | latest | revisions | annotate | diff | comparison | raw | help
Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
libraries/spcre/libpcre/pcre/doc/html/pcretest.html
author Tom Sutcliffe <thomas.sutcliffe@accenture.com>
Sat, 31 Jul 2010 19:07:57 +0100
changeset 23 092bcc217d9d
parent 0 7f656887cf89
permissions -rw-r--r--
Tidied iocli exports, build macro tweaks. Removed 4 overloads of CCommandBase::RunCommand[L] that are no longer used at all, and changed one more to not be exported as it's only used internally to iocli.dll. fixed builds on platforms that don't support btrace or any form of tracing.
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
0
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
     1
 
<html>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
     2
 
<head>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
     3
 
<title>pcretest specification</title>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
     4
 
</head>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
     5
 
<body bgcolor="#FFFFFF" text="#00005A" link="#0066FF" alink="#3399FF" vlink="#2222BB">
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
     6
 
<h1>pcretest man page</h1>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
     7
 
<p>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
     8
 
Return to the <a href="index.html">PCRE index page</a>.
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
     9
 
</p>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    10
 
<p>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    11
 
This page is part of the PCRE HTML documentation. It was generated automatically
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    12
 
from the original man page. If there is any nonsense in it, please consult the
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    13
 
man page, in case the conversion went wrong.
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    14
 
<br>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    15
 
<ul>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    16
 
<li><a name="TOC1" href="#SEC1">SYNOPSIS</a>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    17
 
<li><a name="TOC2" href="#SEC2">OPTIONS</a>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    18
 
<li><a name="TOC3" href="#SEC3">DESCRIPTION</a>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    19
 
<li><a name="TOC4" href="#SEC4">PATTERN MODIFIERS</a>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    20
 
<li><a name="TOC5" href="#SEC5">DATA LINES</a>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    21
 
<li><a name="TOC6" href="#SEC6">THE ALTERNATIVE MATCHING FUNCTION</a>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    22
 
<li><a name="TOC7" href="#SEC7">DEFAULT OUTPUT FROM PCRETEST</a>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    23
 
<li><a name="TOC8" href="#SEC8">OUTPUT FROM THE ALTERNATIVE MATCHING FUNCTION</a>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    24
 
<li><a name="TOC9" href="#SEC9">RESTARTING AFTER A PARTIAL MATCH</a>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    25
 
<li><a name="TOC10" href="#SEC10">CALLOUTS</a>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    26
 
<li><a name="TOC11" href="#SEC11">NON-PRINTING CHARACTERS</a>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    27
 
<li><a name="TOC12" href="#SEC12">SAVING AND RELOADING COMPILED PATTERNS</a>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    28
 
<li><a name="TOC13" href="#SEC13">SEE ALSO</a>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    29
 
<li><a name="TOC14" href="#SEC14">AUTHOR</a>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    30
 
<li><a name="TOC15" href="#SEC15">REVISION</a>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    31
 
</ul>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    32
 
<br><a name="SEC1" href="#TOC1">SYNOPSIS</a><br>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    33
 
<P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    34
 
<b>pcretest [options] [source] [destination]</b>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    35
 
<br>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    36
 
<br>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    37
 
<b>pcretest</b> was written as a test program for the PCRE regular expression
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    38
 
library itself, but it can also be used for experimenting with regular
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    39
 
expressions. This document describes the features of the test program; for
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    40
 
details of the regular expressions themselves, see the
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    41
 
<a href="pcrepattern.html"><b>pcrepattern</b></a>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    42
 
documentation. For details of the PCRE library function calls and their
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    43
 
options, see the
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    44
 
<a href="pcreapi.html"><b>pcreapi</b></a>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    45
 
documentation.
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    46
 
</P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    47
 
<br><a name="SEC2" href="#TOC1">OPTIONS</a><br>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    48
 
<P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    49
 
<b>-b</b>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    50
 
Behave as if each regex has the <b>/B</b> (show bytecode) modifier; the internal
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    51
 
form is output after compilation.
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    52
 
</P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    53
 
<P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    54
 
<b>-C</b>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    55
 
Output the version number of the PCRE library, and all available information
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    56
 
about the optional features that are included, and then exit.
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    57
 
</P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    58
 
<P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    59
 
<b>-d</b>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    60
 
Behave as if each regex has the <b>/D</b> (debug) modifier; the internal
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    61
 
form and information about the compiled pattern is output after compilation;
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    62
 
<b>-d</b> is equivalent to <b>-b -i</b>.
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    63
 
</P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    64
 
<P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    65
 
<b>-dfa</b>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    66
 
Behave as if each data line contains the \D escape sequence; this causes the
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    67
 
alternative matching function, <b>pcre_dfa_exec()</b>, to be used instead of the
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    68
 
standard <b>pcre_exec()</b> function (more detail is given below).
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    69
 
</P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    70
 
<P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    71
 
<b>-help</b>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    72
 
Output a brief summary these options and then exit.
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    73
 
</P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    74
 
<P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    75
 
<b>-i</b>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    76
 
Behave as if each regex has the <b>/I</b> modifier; information about the
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    77
 
compiled pattern is given after compilation.
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    78
 
</P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    79
 
<P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    80
 
<b>-m</b>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    81
 
Output the size of each compiled pattern after it has been compiled. This is
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    82
 
equivalent to adding <b>/M</b> to each regular expression. For compatibility
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    83
 
with earlier versions of pcretest, <b>-s</b> is a synonym for <b>-m</b>.
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    84
 
</P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    85
 
<P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    86
 
<b>-o</b> <i>osize</i>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    87
 
Set the number of elements in the output vector that is used when calling
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    88
 
<b>pcre_exec()</b> or <b>pcre_dfa_exec()</b> to be <i>osize</i>. The default value
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    89
 
is 45, which is enough for 14 capturing subexpressions for <b>pcre_exec()</b> or
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    90
 
22 different matches for <b>pcre_dfa_exec()</b>. The vector size can be
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    91
 
changed for individual matching calls by including \O in the data line (see
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    92
 
below).
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    93
 
</P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    94
 
<P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    95
 
<b>-p</b>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    96
 
Behave as if each regex has the <b>/P</b> modifier; the POSIX wrapper API is
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    97
 
used to call PCRE. None of the other options has any effect when <b>-p</b> is
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    98
 
set.
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
    99
 
</P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   100
 
<P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   101
 
<b>-q</b>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   102
 
Do not output the version number of <b>pcretest</b> at the start of execution.
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   103
 
</P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   104
 
<P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   105
 
<b>-S</b> <i>size</i>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   106
 
On Unix-like systems, set the size of the runtime stack to <i>size</i>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   107
 
megabytes.
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   108
 
</P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   109
 
<P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   110
 
<b>-t</b>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   111
 
Run each compile, study, and match many times with a timer, and output
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   112
 
resulting time per compile or match (in milliseconds). Do not set <b>-m</b> with
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   113
 
<b>-t</b>, because you will then get the size output a zillion times, and the
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   114
 
timing will be distorted. You can control the number of iterations that are
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   115
 
used for timing by following <b>-t</b> with a number (as a separate item on the
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   116
 
command line). For example, "-t 1000" would iterate 1000 times. The default is
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   117
 
to iterate 500000 times.
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   118
 
</P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   119
 
<P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   120
 
<b>-tm</b>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   121
 
This is like <b>-t</b> except that it times only the matching phase, not the
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   122
 
compile or study phases.
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   123
 
</P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   124
 
<br><a name="SEC3" href="#TOC1">DESCRIPTION</a><br>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   125
 
<P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   126
 
If <b>pcretest</b> is given two filename arguments, it reads from the first and
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   127
 
writes to the second. If it is given only one filename argument, it reads from
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   128
 
that file and writes to stdout. Otherwise, it reads from stdin and writes to
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   129
 
stdout, and prompts for each line of input, using "re&#62;" to prompt for regular
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   130
 
expressions, and "data&#62;" to prompt for data lines.
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   131
 
</P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   132
 
<P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   133
 
When <b>pcretest</b> is built, a configuration option can specify that it should
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   134
 
be linked with the <b>libreadline</b> library. When this is done, if the input
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   135
 
is from a terminal, it is read using the <b>readline()</b> function. This
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   136
 
provides line-editing and history facilities. The output from the <b>-help</b>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   137
 
option states whether or not <b>readline()</b> will be used.
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   138
 
</P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   139
 
<P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   140
 
The program handles any number of sets of input on a single input file. Each
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   141
 
set starts with a regular expression, and continues with any number of data
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   142
 
lines to be matched against the pattern.
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   143
 
</P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   144
 
<P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   145
 
Each data line is matched separately and independently. If you want to do
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   146
 
multi-line matches, you have to use the \n escape sequence (or \r or \r\n,
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   147
 
etc., depending on the newline setting) in a single line of input to encode the
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   148
 
newline sequences. There is no limit on the length of data lines; the input
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   149
 
buffer is automatically extended if it is too small.
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   150
 
</P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   151
 
<P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   152
 
An empty line signals the end of the data lines, at which point a new regular
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   153
 
expression is read. The regular expressions are given enclosed in any
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   154
 
non-alphanumeric delimiters other than backslash, for example:
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   155
 
<pre>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   156
 
  /(a|bc)x+yz/
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   157
 
</pre>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   158
 
White space before the initial delimiter is ignored. A regular expression may
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   159
 
be continued over several input lines, in which case the newline characters are
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   160
 
included within it. It is possible to include the delimiter within the pattern
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   161
 
by escaping it, for example
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   162
 
<pre>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   163
 
  /abc\/def/
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   164
 
</pre>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   165
 
If you do so, the escape and the delimiter form part of the pattern, but since
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   166
 
delimiters are always non-alphanumeric, this does not affect its interpretation.
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   167
 
If the terminating delimiter is immediately followed by a backslash, for
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   168
 
example,
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   169
 
<pre>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   170
 
  /abc/\
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   171
 
</pre>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   172
 
then a backslash is added to the end of the pattern. This is done to provide a
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   173
 
way of testing the error condition that arises if a pattern finishes with a
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   174
 
backslash, because
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   175
 
<pre>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   176
 
  /abc\/
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   177
 
</pre>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   178
 
is interpreted as the first line of a pattern that starts with "abc/", causing
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   179
 
pcretest to read the next line as a continuation of the regular expression.
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   180
 
</P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   181
 
<br><a name="SEC4" href="#TOC1">PATTERN MODIFIERS</a><br>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   182
 
<P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   183
 
A pattern may be followed by any number of modifiers, which are mostly single
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   184
 
characters. Following Perl usage, these are referred to below as, for example,
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   185
 
"the <b>/i</b> modifier", even though the delimiter of the pattern need not
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   186
 
always be a slash, and no slash is used when writing modifiers. Whitespace may
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   187
 
appear between the final pattern delimiter and the first modifier, and between
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   188
 
the modifiers themselves.
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   189
 
</P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   190
 
<P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   191
 
The <b>/i</b>, <b>/m</b>, <b>/s</b>, and <b>/x</b> modifiers set the PCRE_CASELESS,
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   192
 
PCRE_MULTILINE, PCRE_DOTALL, or PCRE_EXTENDED options, respectively, when
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   193
 
<b>pcre_compile()</b> is called. These four modifier letters have the same
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   194
 
effect as they do in Perl. For example:
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   195
 
<pre>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   196
 
  /caseless/i
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   197
 
</pre>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   198
 
The following table shows additional modifiers for setting PCRE options that do
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   199
 
not correspond to anything in Perl:
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   200
 
<pre>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   201
 
  <b>/A</b>              PCRE_ANCHORED
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   202
 
  <b>/C</b>              PCRE_AUTO_CALLOUT
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   203
 
  <b>/E</b>              PCRE_DOLLAR_ENDONLY
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   204
 
  <b>/f</b>              PCRE_FIRSTLINE
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   205
 
  <b>/J</b>              PCRE_DUPNAMES
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   206
 
  <b>/N</b>              PCRE_NO_AUTO_CAPTURE
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   207
 
  <b>/U</b>              PCRE_UNGREEDY
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   208
 
  <b>/X</b>              PCRE_EXTRA
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   209
 
  <b>/&#60;JS&#62;</b>           PCRE_JAVASCRIPT_COMPAT
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   210
 
  <b>/&#60;cr&#62;</b>           PCRE_NEWLINE_CR
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   211
 
  <b>/&#60;lf&#62;</b>           PCRE_NEWLINE_LF
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   212
 
  <b>/&#60;crlf&#62;</b>         PCRE_NEWLINE_CRLF
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   213
 
  <b>/&#60;anycrlf&#62;</b>      PCRE_NEWLINE_ANYCRLF
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   214
 
  <b>/&#60;any&#62;</b>          PCRE_NEWLINE_ANY
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   215
 
  <b>/&#60;bsr_anycrlf&#62;</b>  PCRE_BSR_ANYCRLF
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   216
 
  <b>/&#60;bsr_unicode&#62;</b>  PCRE_BSR_UNICODE
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   217
 
</pre>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   218
 
Those specifying line ending sequences are literal strings as shown, but the
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   219
 
letters can be in either case. This example sets multiline matching with CRLF
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   220
 
as the line ending sequence:
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   221
 
<pre>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   222
 
  /^abc/m&#60;crlf&#62;
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   223
 
</pre>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   224
 
Details of the meanings of these PCRE options are given in the
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   225
 
<a href="pcreapi.html"><b>pcreapi</b></a>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   226
 
documentation.
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   227
 
</P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   228
 
<br><b>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   229
 
Finding all matches in a string
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   230
 
</b><br>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   231
 
<P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   232
 
Searching for all possible matches within each subject string can be requested
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   233
 
by the <b>/g</b> or <b>/G</b> modifier. After finding a match, PCRE is called
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   234
 
again to search the remainder of the subject string. The difference between
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   235
 
<b>/g</b> and <b>/G</b> is that the former uses the <i>startoffset</i> argument to
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   236
 
<b>pcre_exec()</b> to start searching at a new point within the entire string
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   237
 
(which is in effect what Perl does), whereas the latter passes over a shortened
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   238
 
substring. This makes a difference to the matching process if the pattern
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   239
 
begins with a lookbehind assertion (including \b or \B).
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   240
 
</P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   241
 
<P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   242
 
If any call to <b>pcre_exec()</b> in a <b>/g</b> or <b>/G</b> sequence matches an
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   243
 
empty string, the next call is done with the PCRE_NOTEMPTY and PCRE_ANCHORED
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   244
 
flags set in order to search for another, non-empty, match at the same point.
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   245
 
If this second match fails, the start offset is advanced by one, and the normal
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   246
 
match is retried. This imitates the way Perl handles such cases when using the
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   247
 
<b>/g</b> modifier or the <b>split()</b> function.
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   248
 
</P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   249
 
<br><b>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   250
 
Other modifiers
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   251
 
</b><br>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   252
 
<P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   253
 
There are yet more modifiers for controlling the way <b>pcretest</b>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   254
 
operates.
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   255
 
</P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   256
 
<P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   257
 
The <b>/+</b> modifier requests that as well as outputting the substring that
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   258
 
matched the entire pattern, pcretest should in addition output the remainder of
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   259
 
the subject string. This is useful for tests where the subject contains
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   260
 
multiple copies of the same substring.
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   261
 
</P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   262
 
<P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   263
 
The <b>/B</b> modifier is a debugging feature. It requests that <b>pcretest</b>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   264
 
output a representation of the compiled byte code after compilation. Normally
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   265
 
this information contains length and offset values; however, if <b>/Z</b> is
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   266
 
also present, this data is replaced by spaces. This is a special feature for
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   267
 
use in the automatic test scripts; it ensures that the same output is generated
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   268
 
for different internal link sizes.
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   269
 
</P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   270
 
<P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   271
 
The <b>/L</b> modifier must be followed directly by the name of a locale, for
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   272
 
example,
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   273
 
<pre>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   274
 
  /pattern/Lfr_FR
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   275
 
</pre>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   276
 
For this reason, it must be the last modifier. The given locale is set,
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   277
 
<b>pcre_maketables()</b> is called to build a set of character tables for the
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   278
 
locale, and this is then passed to <b>pcre_compile()</b> when compiling the
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   279
 
regular expression. Without an <b>/L</b> modifier, NULL is passed as the tables
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   280
 
pointer; that is, <b>/L</b> applies only to the expression on which it appears.
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   281
 
</P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   282
 
<P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   283
 
The <b>/I</b> modifier requests that <b>pcretest</b> output information about the
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   284
 
compiled pattern (whether it is anchored, has a fixed first character, and
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   285
 
so on). It does this by calling <b>pcre_fullinfo()</b> after compiling a
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   286
 
pattern. If the pattern is studied, the results of that are also output.
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   287
 
</P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   288
 
<P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   289
 
The <b>/D</b> modifier is a PCRE debugging feature, and is equivalent to
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   290
 
<b>/BI</b>, that is, both the <b>/B</b> and the <b>/I</b> modifiers.
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   291
 
</P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   292
 
<P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   293
 
The <b>/F</b> modifier causes <b>pcretest</b> to flip the byte order of the
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   294
 
fields in the compiled pattern that contain 2-byte and 4-byte numbers. This
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   295
 
facility is for testing the feature in PCRE that allows it to execute patterns
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   296
 
that were compiled on a host with a different endianness. This feature is not
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   297
 
available when the POSIX interface to PCRE is being used, that is, when the
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   298
 
<b>/P</b> pattern modifier is specified. See also the section about saving and
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   299
 
reloading compiled patterns below.
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   300
 
</P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   301
 
<P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   302
 
The <b>/S</b> modifier causes <b>pcre_study()</b> to be called after the
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   303
 
expression has been compiled, and the results used when the expression is
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   304
 
matched.
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   305
 
</P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   306
 
<P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   307
 
The <b>/M</b> modifier causes the size of memory block used to hold the compiled
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   308
 
pattern to be output.
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   309
 
</P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   310
 
<P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   311
 
The <b>/P</b> modifier causes <b>pcretest</b> to call PCRE via the POSIX wrapper
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   312
 
API rather than its native API. When this is done, all other modifiers except
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   313
 
<b>/i</b>, <b>/m</b>, and <b>/+</b> are ignored. REG_ICASE is set if <b>/i</b> is
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   314
 
present, and REG_NEWLINE is set if <b>/m</b> is present. The wrapper functions
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   315
 
force PCRE_DOLLAR_ENDONLY always, and PCRE_DOTALL unless REG_NEWLINE is set.
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   316
 
</P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   317
 
<P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   318
 
The <b>/8</b> modifier causes <b>pcretest</b> to call PCRE with the PCRE_UTF8
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   319
 
option set. This turns on support for UTF-8 character handling in PCRE,
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   320
 
provided that it was compiled with this support enabled. This modifier also
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   321
 
causes any non-printing characters in output strings to be printed using the
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   322
 
\x{hh...} notation if they are valid UTF-8 sequences.
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   323
 
</P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   324
 
<P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   325
 
If the <b>/?</b> modifier is used with <b>/8</b>, it causes <b>pcretest</b> to
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   326
 
call <b>pcre_compile()</b> with the PCRE_NO_UTF8_CHECK option, to suppress the
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   327
 
checking of the string for UTF-8 validity.
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   328
 
</P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   329
 
<br><a name="SEC5" href="#TOC1">DATA LINES</a><br>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   330
 
<P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   331
 
Before each data line is passed to <b>pcre_exec()</b>, leading and trailing
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   332
 
whitespace is removed, and it is then scanned for \ escapes. Some of these are
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   333
 
pretty esoteric features, intended for checking out some of the more
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   334
 
complicated features of PCRE. If you are just testing "ordinary" regular
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   335
 
expressions, you probably don't need any of these. The following escapes are
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   336
 
recognized:
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   337
 
<pre>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   338
 
  \a         alarm (BEL, \x07)
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   339
 
  \b         backspace (\x08)
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   340
 
  \e         escape (\x27)
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   341
 
  \f         formfeed (\x0c)
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   342
 
  \n         newline (\x0a)
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   343
 
  \qdd       set the PCRE_MATCH_LIMIT limit to dd (any number of digits)
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   344
 
  \r         carriage return (\x0d)
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   345
 
  \t         tab (\x09)
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   346
 
  \v         vertical tab (\x0b)
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   347
 
  \nnn       octal character (up to 3 octal digits)
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   348
 
  \xhh       hexadecimal character (up to 2 hex digits)
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   349
 
  \x{hh...}  hexadecimal character, any number of digits in UTF-8 mode
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   350
 
  \A         pass the PCRE_ANCHORED option to <b>pcre_exec()</b> or <b>pcre_dfa_exec()</b>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   351
 
  \B         pass the PCRE_NOTBOL option to <b>pcre_exec()</b> or <b>pcre_dfa_exec()</b>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   352
 
  \Cdd       call pcre_copy_substring() for substring dd after a successful match (number less than 32)
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   353
 
  \Cname     call pcre_copy_named_substring() for substring "name" after a successful match (name termin-
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   354
 
               ated by next non alphanumeric character)
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   355
 
  \C+        show the current captured substrings at callout time
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   356
 
  \C-        do not supply a callout function
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   357
 
  \C!n       return 1 instead of 0 when callout number n is reached
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   358
 
  \C!n!m     return 1 instead of 0 when callout number n is reached for the nth time
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   359
 
  \C*n       pass the number n (may be negative) as callout data; this is used as the callout return value
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   360
 
  \D         use the <b>pcre_dfa_exec()</b> match function
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   361
 
  \F         only shortest match for <b>pcre_dfa_exec()</b>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   362
 
  \Gdd       call pcre_get_substring() for substring dd after a successful match (number less than 32)
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   363
 
  \Gname     call pcre_get_named_substring() for substring "name" after a successful match (name termin-
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   364
 
               ated by next non-alphanumeric character)
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   365
 
  \L         call pcre_get_substringlist() after a successful match
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   366
 
  \M         discover the minimum MATCH_LIMIT and MATCH_LIMIT_RECURSION settings
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   367
 
  \N         pass the PCRE_NOTEMPTY option to <b>pcre_exec()</b> or <b>pcre_dfa_exec()</b>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   368
 
  \Odd       set the size of the output vector passed to <b>pcre_exec()</b> to dd (any number of digits)
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   369
 
  \P         pass the PCRE_PARTIAL option to <b>pcre_exec()</b> or <b>pcre_dfa_exec()</b>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   370
 
  \Qdd       set the PCRE_MATCH_LIMIT_RECURSION limit to dd (any number of digits)
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   371
 
  \R         pass the PCRE_DFA_RESTART option to <b>pcre_dfa_exec()</b>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   372
 
  \S         output details of memory get/free calls during matching
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   373
 
  \Z         pass the PCRE_NOTEOL option to <b>pcre_exec()</b> or <b>pcre_dfa_exec()</b>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   374
 
  \?         pass the PCRE_NO_UTF8_CHECK option to <b>pcre_exec()</b> or <b>pcre_dfa_exec()</b>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   375
 
  \&#62;dd       start the match at offset dd (any number of digits);
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   376
 
               this sets the <i>startoffset</i> argument for <b>pcre_exec()</b> or <b>pcre_dfa_exec()</b>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   377
 
  \&#60;cr&#62;      pass the PCRE_NEWLINE_CR option to <b>pcre_exec()</b> or <b>pcre_dfa_exec()</b>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   378
 
  \&#60;lf&#62;      pass the PCRE_NEWLINE_LF option to <b>pcre_exec()</b> or <b>pcre_dfa_exec()</b>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   379
 
  \&#60;crlf&#62;    pass the PCRE_NEWLINE_CRLF option to <b>pcre_exec()</b> or <b>pcre_dfa_exec()</b>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   380
 
  \&#60;anycrlf&#62; pass the PCRE_NEWLINE_ANYCRLF option to <b>pcre_exec()</b> or <b>pcre_dfa_exec()</b>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   381
 
  \&#60;any&#62;     pass the PCRE_NEWLINE_ANY option to <b>pcre_exec()</b> or <b>pcre_dfa_exec()</b>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   382
 
</pre>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   383
 
The escapes that specify line ending sequences are literal strings, exactly as
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   384
 
shown. No more than one newline setting should be present in any data line.
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   385
 
</P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   386
 
<P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   387
 
A backslash followed by anything else just escapes the anything else. If
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   388
 
the very last character is a backslash, it is ignored. This gives a way of
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   389
 
passing an empty line as data, since a real empty line terminates the data
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   390
 
input.
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   391
 
</P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   392
 
<P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   393
 
If \M is present, <b>pcretest</b> calls <b>pcre_exec()</b> several times, with
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   394
 
different values in the <i>match_limit</i> and <i>match_limit_recursion</i>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   395
 
fields of the <b>pcre_extra</b> data structure, until it finds the minimum
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   396
 
numbers for each parameter that allow <b>pcre_exec()</b> to complete. The
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   397
 
<i>match_limit</i> number is a measure of the amount of backtracking that takes
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   398
 
place, and checking it out can be instructive. For most simple matches, the
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   399
 
number is quite small, but for patterns with very large numbers of matching
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   400
 
possibilities, it can become large very quickly with increasing length of
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   401
 
subject string. The <i>match_limit_recursion</i> number is a measure of how much
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   402
 
stack (or, if PCRE is compiled with NO_RECURSE, how much heap) memory is needed
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   403
 
to complete the match attempt.
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   404
 
</P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   405
 
<P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   406
 
When \O is used, the value specified may be higher or lower than the size set
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   407
 
by the <b>-O</b> command line option (or defaulted to 45); \O applies only to
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   408
 
the call of <b>pcre_exec()</b> for the line in which it appears.
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   409
 
</P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   410
 
<P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   411
 
If the <b>/P</b> modifier was present on the pattern, causing the POSIX wrapper
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   412
 
API to be used, the only option-setting sequences that have any effect are \B
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   413
 
and \Z, causing REG_NOTBOL and REG_NOTEOL, respectively, to be passed to
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   414
 
<b>regexec()</b>.
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   415
 
</P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   416
 
<P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   417
 
The use of \x{hh...} to represent UTF-8 characters is not dependent on the use
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   418
 
of the <b>/8</b> modifier on the pattern. It is recognized always. There may be
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   419
 
any number of hexadecimal digits inside the braces. The result is from one to
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   420
 
six bytes, encoded according to the original UTF-8 rules of RFC 2279. This
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   421
 
allows for values in the range 0 to 0x7FFFFFFF. Note that not all of those are
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   422
 
valid Unicode code points, or indeed valid UTF-8 characters according to the
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   423
 
later rules in RFC 3629.
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   424
 
</P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   425
 
<br><a name="SEC6" href="#TOC1">THE ALTERNATIVE MATCHING FUNCTION</a><br>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   426
 
<P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   427
 
By default, <b>pcretest</b> uses the standard PCRE matching function,
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   428
 
<b>pcre_exec()</b> to match each data line. From release 6.0, PCRE supports an
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   429
 
alternative matching function, <b>pcre_dfa_test()</b>, which operates in a
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   430
 
different way, and has some restrictions. The differences between the two
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   431
 
functions are described in the
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   432
 
<a href="pcrematching.html"><b>pcrematching</b></a>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   433
 
documentation.
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   434
 
</P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   435
 
<P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   436
 
If a data line contains the \D escape sequence, or if the command line
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   437
 
contains the <b>-dfa</b> option, the alternative matching function is called.
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   438
 
This function finds all possible matches at a given point. If, however, the \F
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   439
 
escape sequence is present in the data line, it stops after the first match is
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   440
 
found. This is always the shortest possible match.
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   441
 
</P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   442
 
<br><a name="SEC7" href="#TOC1">DEFAULT OUTPUT FROM PCRETEST</a><br>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   443
 
<P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   444
 
This section describes the output when the normal matching function,
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   445
 
<b>pcre_exec()</b>, is being used.
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   446
 
</P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   447
 
<P>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   448
 
When a match succeeds, pcretest outputs the list of captured substrings that
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   449
 
<b>pcre_exec()</b> returns, starting with number 0 for the string that matched
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   450
 
the whole pattern. Otherwise, it outputs "No match" or "Partial match"
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   451
 
when <b>pcre_exec()</b> returns PCRE_ERROR_NOMATCH or PCRE_ERROR_PARTIAL,
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   452
 
respectively, and otherwise the PCRE negative error number. Here is an example
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   453
 
of an interactive <b>pcretest</b> run.
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   454
 
<pre>
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   455
 
  $ pcretest
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   456
 
  PCRE version 7.0 30-Nov-2006
7f656887cf89 First submission to Symbian Foundation staging server.
Tom Sutcliffe <thomas.sutcliffe@accenture.com>
parents:
diff changeset 
   457
 












7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   458


    re&#62; /^abc(\d+)/













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   459


  data&#62; abc123













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   460


   0: abc123













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   461


   1: 123













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   462


  data&#62; xyz













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   463


  No match













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   464


</pre>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   465


Note that unset capturing substrings that are not followed by one that is set













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   466


are not returned by <b>pcre_exec()</b>, and are not shown by <b>pcretest</b>. In













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   467


the following example, there are two capturing substrings, but when the first













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   468


data line is matched, the second, unset substring is not shown. An "internal"













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   469


unset substring is shown as "&#60;unset&#62;", as for the second data line.













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   470


<pre>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   471


    re&#62; /(a)|(b)/













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   472


  data&#62; a













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   473


   0: a













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   474


   1: a













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   475


  data&#62; b













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   476


   0: b













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   477


   1: &#60;unset&#62;













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   478


   2: b













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   479


</pre>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   480


If the strings contain any non-printing characters, they are output as \0x













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   481


escapes, or as \x{...} escapes if the <b>/8</b> modifier was present on the













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   482


pattern. See below for the definition of non-printing characters. If the













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   483


pattern has the <b>/+</b> modifier, the output for substring 0 is followed by













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   484


the the rest of the subject string, identified by "0+" like this:













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   485


<pre>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   486


    re&#62; /cat/+













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   487


  data&#62; cataract













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   488


   0: cat













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   489


   0+ aract













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   490


</pre>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   491


If the pattern has the <b>/g</b> or <b>/G</b> modifier, the results of successive













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   492


matching attempts are output in sequence, like this:













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   493


<pre>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   494


    re&#62; /\Bi(\w\w)/g













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   495


  data&#62; Mississippi













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   496


   0: iss













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   497


   1: ss













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   498


   0: iss













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   499


   1: ss













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   500


   0: ipp













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   501


   1: pp













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   502


</pre>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   503


"No match" is output only if the first match attempt fails.













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   504


</P>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   505


<P>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   506


If any of the sequences <b>\C</b>, <b>\G</b>, or <b>\L</b> are present in a













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   507


data line that is successfully matched, the substrings extracted by the













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   508


convenience functions are output with C, G, or L after the string number













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   509


instead of a colon. This is in addition to the normal full list. The string













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   510


length (that is, the return from the extraction function) is given in













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   511


parentheses after each string for <b>\C</b> and <b>\G</b>.













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   512


</P>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   513


<P>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   514


Note that whereas patterns can be continued over several lines (a plain "&#62;"













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   515


prompt is used for continuations), data lines may not. However newlines can be













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   516


included in data by means of the \n escape (or \r, \r\n, etc., depending on













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   517


the newline sequence setting).













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   518


</P>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   519


<br><a name="SEC8" href="#TOC1">OUTPUT FROM THE ALTERNATIVE MATCHING FUNCTION</a><br>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   520


<P>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   521


When the alternative matching function, <b>pcre_dfa_exec()</b>, is used (by













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   522


means of the \D escape sequence or the <b>-dfa</b> command line option), the













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   523


output consists of a list of all the matches that start at the first point in













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   524


the subject where there is at least one match. For example:













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   525


<pre>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   526


    re&#62; /(tang|tangerine|tan)/













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   527


  data&#62; yellow tangerine\D













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   528


   0: tangerine













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   529


   1: tang













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   530


   2: tan













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   531


</pre>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   532


(Using the normal matching function on this data finds only "tang".) The













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   533


longest matching string is always given first (and numbered zero).













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   534


</P>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   535


<P>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   536


If <b>/g</b> is present on the pattern, the search for further matches resumes













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   537


at the end of the longest match. For example:













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   538


<pre>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   539


    re&#62; /(tang|tangerine|tan)/g













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   540


  data&#62; yellow tangerine and tangy sultana\D













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   541


   0: tangerine













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   542


   1: tang













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   543


   2: tan













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   544


   0: tang













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   545


   1: tan













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   546


   0: tan













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   547


</pre>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   548


Since the matching function does not support substring capture, the escape













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   549


sequences that are concerned with captured substrings are not relevant.













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   550


</P>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   551


<br><a name="SEC9" href="#TOC1">RESTARTING AFTER A PARTIAL MATCH</a><br>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   552


<P>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   553


When the alternative matching function has given the PCRE_ERROR_PARTIAL return,













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   554


indicating that the subject partially matched the pattern, you can restart the













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   555


match with additional subject data by means of the \R escape sequence. For













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   556


example:













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   557


<pre>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   558


    re&#62; /^\d?\d(jan|feb|mar|apr|may|jun|jul|aug|sep|oct|nov|dec)\d\d$/













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   559


  data&#62; 23ja\P\D













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   560


  Partial match: 23ja













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   561


  data&#62; n05\R\D













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   562


   0: n05













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   563


</pre>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   564


For further information about partial matching, see the













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   565


<a href="pcrepartial.html"><b>pcrepartial</b></a>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   566


documentation.













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   567


</P>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   568


<br><a name="SEC10" href="#TOC1">CALLOUTS</a><br>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   569


<P>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   570


If the pattern contains any callout requests, <b>pcretest</b>'s callout function













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   571


is called during matching. This works with both matching functions. By default,













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   572


the called function displays the callout number, the start and current













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   573


positions in the text at the callout time, and the next pattern item to be













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   574


tested. For example, the output













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   575


<pre>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   576


  ---&#62;pqrabcdef













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   577


    0    ^  ^     \d













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   578


</pre>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   579


indicates that callout number 0 occurred for a match attempt starting at the













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   580


fourth character of the subject string, when the pointer was at the seventh













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   581


character of the data, and when the next pattern item was \d. Just one













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   582


circumflex is output if the start and current positions are the same.













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   583


</P>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   584


<P>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   585


Callouts numbered 255 are assumed to be automatic callouts, inserted as a













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   586


result of the <b>/C</b> pattern modifier. In this case, instead of showing the













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   587


callout number, the offset in the pattern, preceded by a plus, is output. For













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   588


example:













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   589


<pre>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   590


    re&#62; /\d?[A-E]\*/C













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   591


  data&#62; E*













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   592


  ---&#62;E*













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   593


   +0 ^      \d?













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   594


   +3 ^      [A-E]













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   595


   +8 ^^     \*













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   596


  +10 ^ ^













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   597


   0: E*













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   598


</pre>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   599


The callout function in <b>pcretest</b> returns zero (carry on matching) by













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   600


default, but you can use a \C item in a data line (as described above) to













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   601


change this.













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   602


</P>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   603


<P>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   604


Inserting callouts can be helpful when using <b>pcretest</b> to check













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   605


complicated regular expressions. For further information about callouts, see













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   606


the













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   607


<a href="pcrecallout.html"><b>pcrecallout</b></a>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   608


documentation.













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   609


</P>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   610


<br><a name="SEC11" href="#TOC1">NON-PRINTING CHARACTERS</a><br>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   611


<P>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   612


When <b>pcretest</b> is outputting text in the compiled version of a pattern,













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   613


bytes other than 32-126 are always treated as non-printing characters are are













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   614


therefore shown as hex escapes.













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   615


</P>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   616


<P>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   617


When <b>pcretest</b> is outputting text that is a matched part of a subject













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   618


string, it behaves in the same way, unless a different locale has been set for













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   619


the pattern (using the <b>/L</b> modifier). In this case, the <b>isprint()</b>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   620


function to distinguish printing and non-printing characters.













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   621


</P>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   622


<br><a name="SEC12" href="#TOC1">SAVING AND RELOADING COMPILED PATTERNS</a><br>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   623


<P>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   624


The facilities described in this section are not available when the POSIX













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   625


inteface to PCRE is being used, that is, when the <b>/P</b> pattern modifier is













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   626


specified.













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   627


</P>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   628


<P>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   629


When the POSIX interface is not in use, you can cause <b>pcretest</b> to write a













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   630


compiled pattern to a file, by following the modifiers with &#62; and a file name.













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   631


For example:













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   632


<pre>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   633


  /pattern/im &#62;/some/file













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   634


</pre>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   635


See the













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   636


<a href="pcreprecompile.html"><b>pcreprecompile</b></a>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   637


documentation for a discussion about saving and re-using compiled patterns.













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   638


</P>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   639


<P>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   640


The data that is written is binary. The first eight bytes are the length of the













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   641


compiled pattern data followed by the length of the optional study data, each













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   642


written as four bytes in big-endian order (most significant byte first). If













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   643


there is no study data (either the pattern was not studied, or studying did not













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   644


return any data), the second length is zero. The lengths are followed by an













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   645


exact copy of the compiled pattern. If there is additional study data, this













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   646


follows immediately after the compiled pattern. After writing the file,













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   647


<b>pcretest</b> expects to read a new pattern.













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   648


</P>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   649


<P>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   650


A saved pattern can be reloaded into <b>pcretest</b> by specifing &#60; and a file













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   651


name instead of a pattern. The name of the file must not contain a &#60; character,













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   652


as otherwise <b>pcretest</b> will interpret the line as a pattern delimited by &#60;













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   653


characters.













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   654


For example:













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   655


<pre>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   656


   re&#62; &#60;/some/file













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   657


  Compiled regex loaded from /some/file













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   658


  No study data













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   659


</pre>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   660


When the pattern has been loaded, <b>pcretest</b> proceeds to read data lines in













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   661


the usual way.













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   662


</P>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   663


<P>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   664


You can copy a file written by <b>pcretest</b> to a different host and reload it













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   665


there, even if the new host has opposite endianness to the one on which the













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   666


pattern was compiled. For example, you can compile on an i86 machine and run on













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   667


a SPARC machine.













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   668


</P>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   669


<P>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   670


File names for saving and reloading can be absolute or relative, but note that













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   671


the shell facility of expanding a file name that starts with a tilde (~) is not













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   672


available.













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   673


</P>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   674


<P>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   675


The ability to save and reload files in <b>pcretest</b> is intended for testing













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   676


and experimentation. It is not intended for production use because only a













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   677


single pattern can be written to a file. Furthermore, there is no facility for













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   678


supplying custom character tables for use with a reloaded pattern. If the













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   679


original pattern was compiled with custom tables, an attempt to match a subject













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   680


string using a reloaded pattern is likely to cause <b>pcretest</b> to crash.













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   681


Finally, if you attempt to load a file that is not in the correct format, the













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   682


result is undefined.













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   683


</P>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   684


<br><a name="SEC13" href="#TOC1">SEE ALSO</a><br>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   685


<P>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   686


<b>pcre</b>(3), <b>pcreapi</b>(3), <b>pcrecallout</b>(3), <b>pcrematching</b>(3),













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   687


<b>pcrepartial</b>(d), <b>pcrepattern</b>(3), <b>pcreprecompile</b>(3).













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   688


</P>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   689


<br><a name="SEC14" href="#TOC1">AUTHOR</a><br>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   690


<P>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   691


Philip Hazel













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   692


<br>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   693


University Computing Service













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   694


<br>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   695


Cambridge CB2 3QH, England.













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   696


<br>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   697


</P>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   698


<br><a name="SEC15" href="#TOC1">REVISION</a><br>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   699


<P>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   700


Last updated: 12 April 2008













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   701


<br>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   702


Copyright &copy; 1997-2008 University of Cambridge.













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   703


<br>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   704


<p>













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   705


Return to the <a href="index.html">PCRE index page</a>.













7f656887cf89
First submission to Symbian Foundation staging server.



Tom Sutcliffe <thomas.sutcliffe@accenture.com>


parents: 

diff
changeset




   706


</p>















FCL/sf/os/fshell