~ubuntu-branches/ubuntu/hoary/pcre3/hoary-security

« back to all changes in this revision

Viewing changes to doc/perltest.txt

  • Committer: Bazaar Package Importer
  • Author(s): Colin Watson
  • Date: 2001-08-19 20:43:28 UTC
  • Revision ID: james.westby@ubuntu.com-20010819204328-furyhi4ms3c5yjae
Tags: upstream-3.4
ImportĀ upstreamĀ versionĀ 3.4

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
The perltest program
 
2
--------------------
 
3
 
 
4
The perltest program tests Perl's regular expressions; it has the same
 
5
specification as pcretest, and so can be given identical input, except that
 
6
input patterns can be followed only by Perl's lower case modifiers and /+ (as
 
7
used by pcretest), which is recognized and handled by the program.
 
8
 
 
9
The data lines are processed as Perl double-quoted strings, so if they contain
 
10
" \ $ or @ characters, these have to be escaped. For this reason, all such
 
11
characters in testinput1 and testinput3 are escaped so that they can be used
 
12
for perltest as well as for pcretest, and the special upper case modifiers such
 
13
as /A that pcretest recognizes are not used in these files. The output should
 
14
be identical, apart from the initial identifying banner.
 
15
 
 
16
For testing UTF-8 features, an alternative form of perltest, called perltest8,
 
17
is supplied. This requires Perl 5.6 or higher. It recognizes the special
 
18
modifier /8 that pcretest uses to invoke UTF-8 functionality. The testinput5
 
19
file can be fed to perltest8.
 
20
 
 
21
The testinput2 and testinput4 files are not suitable for feeding to perltest,
 
22
since they do make use of the special upper case modifiers and escapes that
 
23
pcretest uses to test some features of PCRE. The first of these files also
 
24
contains malformed regular expressions, in order to check that PCRE diagnoses
 
25
them correctly. Similarly, testinput6 tests UTF-8 features that do not relate
 
26
to Perl.
 
27
 
 
28
Philip Hazel <ph10@cam.ac.uk>
 
29
August 2000