author | Tony Garnock-Jones <tonygarnockjones@gmail.com> |
Tue, 25 May 2010 08:09:57 +1200 | |
changeset 285 | 034958cf32d9 |
parent 11 | 089a57807585 |
permissions | -rw-r--r-- |
11
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
1 |
README |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
2 |
pregexp |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
3 |
Dorai Sitaram |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
4 |
ds26 at gte.com |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
5 |
|
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
6 |
- |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
7 |
|
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
8 |
pregexp is a portable implementation of regular |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
9 |
expressions (regexps) that runs in any R5RS- or |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
10 |
R4RS-compliant implementation of the programming |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
11 |
language Scheme. The regexp notation supported is |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
12 |
compatible with Perl's, and includes such |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
13 |
powerful directives as |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
14 |
|
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
15 |
* numeric quantifiers |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
16 |
* non-greedy quantifiers |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
17 |
* POSIX character classes |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
18 |
* non-capturing clusters (in addition to the usual |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
19 |
capturing kind) |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
20 |
* selective (ie, per-cluster) case-insensitivity |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
21 |
* selective space-insensitivity (with provision |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
22 |
for comments) |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
23 |
* backreferences |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
24 |
* alternation |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
25 |
* backtrack pruning |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
26 |
* lookahead (positive and negative) |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
27 |
* lookbehind (positive and negative) |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
28 |
|
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
29 |
This is in addition to the more basic directives |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
30 |
familiar to all regexp users. |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
31 |
|
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
32 |
To use, simply load the file `pregexp.scm' into your |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
33 |
Scheme. Alternatively, if your dialect allows it, you |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
34 |
can install pregexp as a module -- consult the |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
35 |
file `INSTALL'. |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
36 |
|
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
37 |
However you load pregexp, you will now have |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
38 |
access to the procedures |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
39 |
|
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
40 |
* pregexp |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
41 |
* pregexp-match-positions |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
42 |
* pregexp-match |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
43 |
* pregexp-split |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
44 |
* pregexp-replace |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
45 |
* pregexp-replace* |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
46 |
|
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
47 |
The use of these procedures is described fully and with |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
48 |
examples in the pregexp manual. |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
49 |
|
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
50 |
pregexp.cl is a machine-translation of |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
51 |
pregexp.scm that runs in Common Lisp. |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
52 |
|
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
53 |
The pregexp distribution with documentation may be |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
54 |
downloaded from a link provided in the pregexp manual |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
55 |
on the World Wide Web at |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
56 |
`http://www.ccs.neu.edu/~dorai/pregexp/pregexp.html'. |