1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
|
2012-07-20: Downgraded findlib version requirement to support the Debian
testing branch.
Added --with-pcre-config flag to configure location of PCRE
configuration generator.
2012-07-15: New major release version 7.0.0:
* Upgraded to OCaml 4.00
* Switched to Oasis for packaging
* Switched to OCamlBuild for the build process
* Rewrote README in Markdown
* Added stricter compilation flags
* Minor bugfixes
2012-01-04: Fixed native code debug build target by updating OCamlMakefile.
Thanks to Stéphane Glondu <glondu@debian.org> for the patch!
2011-12-15: Fixed a Windows portability bug in the C-bindings.
Thanks to Evgenii Lepikhin <johnlepikhin@gmail.com> for the patch!
2011-11-09: Updated OCamlMakefile to fix linking order.
2011-01-16: Added support for limit recursion flag.
Thanks to Delphin Lecucq <Delphin.LECUCQ@3ds.com> for the patch!
2010-10-31: Improved Windows support with MSVC.
Thanks to Sylvain Le Gall <sylvain@le-gall.net> for the patch!
2010-04-01: Added new function:
* regexp_or
2009-06-20: Fixed bug in configuration functions that could lead to a segfault.
Thanks to Gerd Stolpmann <gerd@gerd-stolpmann.de> for the patch!
2009-05-07: Changed API wrt. error handling and thus made a major release.
Improved behavior in the presence of recursion limit errors.
Thanks to Martin Jambon <martinj@mylife.com> for this patch!
2009-04-23: Fixed build problem on MinGW.
Thanks to Gerd Stolpmann <gerd@gerd-stolpmann.de> for the patch!
2009-03-08: Fixed build problem on Mac OS X with macports.
Thanks to Ralph Douglass <ralph@grayskies.net> for the
initial patch.
Update OCamlMakefile.
Improved Godi-distribution.
2008-05-06: Fixed build problem with newer versions of PCRE.
2008-03-14: Synced with Jane Street tree.
2008-01-25: Added new function:
* names
This function returns the names of all named substrings in a
regular expression.
Thanks to Benedikt Grundmann <bgrundmann@janestreet.com>
for the patch!
2007-07-12: Improved build scripts for Windows.
Thanks to Christophe Troestler
<Christophe.Troestler@umh.ac.be> for the patch!
2007-07-12: Improved documentation for Win32 builds, and added some build
scripts usable on Windows.
Thanks to Christophe Troestler
<Christophe.Troestler@umh.ac.be> for this contribution!
2007-04-23: callback_exn -> caml_callback_exn.
Updated OCamlMakefile.
2006-11-22: Updated OCamlMakefile.
2006-06-11: Updated to pcre-5.0!
New representation for callbacks: they now take only one
argument (a record of the callback data).
Added partial matching and auto callouts.
2006-01-16: Updated OCamlMakefile.
Removed a superfluous binding.
2005-08-18: Fixed a small compilation problem on rare platforms by
upgrading OCamlMakefile.
2005-06-08: Relaxed license. Fixed copyright headers.
2005-05-31: Fixed some uncleanliness reported by Saffire (FFI-type checker).
2004-09-17: Fixed a bug concerning null patterns in exec_all (extract_all
and extract_all_opt are also affected).
Updated OCamlMakefile.
2004-05-19: Updated Makefile.mingw.
Thanks to Jeff Henrikson <jehenrik@yahoo.com> for the patch!
Updated OCamlMakefile.
2004-04-29: Changed behaviour of "get_substring"!!!
It now does not return the empty string anymore if an
accessed substring was not captured. It raises the exception
"Not_found" instead.
Three new functions:
* get_opt_substrings
* extract_opt
* extract_all_opt
These behave like the functions without "opt", but return
"Some substring" if a substring was captured, and "None"
otherwise.
2004-04-27: Updated OCamlMakefile.
2004-04-24: Updated OCamlMakefile.
2004-03-28: Changed interface to build-time configuration functions
of PCRE.
Updated OCamlMakefile.
2004-02-21: Added CAMLprim in the C-interface where appropriate.
2004-02-08: Fixed a minor bug concerning returning unit values from C.
2004-01-31: Added pcre_make.win32/Makefile.mingw. Thanks to Jeffrey
Henrikson <JEFHEN@SAFECO.com> for this contribution!
Update OCamlMakefile.
2004-01-13: Updated pcre_make.win32/pcre.h.
2003-12-30: Fixed documentation.
2003-12-21: Updated to pcre-4.5!
New function:
* config_stackrecurse
New exception:
* BadUTF8Offset
Updated OCamlMakefile.
2003-12-19: Fixed a small (but probably unnoticable) bug concerning
allocation of optional values in the C-stubs.
2003-12-12: Updated OCamlMakefile. Renamed stubs (invisible to users).
2003-11-16: Updated pcre_make.win32/pcre.h to reflect newest PCRE-version.
May help Windows users.
2003-10-08: Upgraded to pcre-4.4!
New flag for compiling patterns: NO_UTF8_CHECK
New exception: BadUTF8
Updated OCamlMakefile.
2003-09-30: Fixed a bug in the documentation.
Updated OCamlMakefile.
2003-06-17: Fixed a bug in the documentation.
Updated OCamlMakefile.
2003-05-29: Updated to pcre-4.3!
Major change: callouts are now fully supported! This allows
the matching engine call OCaml-code while matching - quite
powerful! Please see the interface specification for more
information.
Many small changes (improvements) in C-code. Updated
documentation.
2003-04-08: Updated OCamlMakefile. Reformatted documentation.
2003-03-20: Added new function "get_subject". Patched OCamlMakefile.
2003-03-18: Major update: upgraded to pcre-4.1!
Better UTF8-support.
New flag "NO_AUTO_CAPTURE".
New values:
* config_utf8
* config_newline
* config_link_size
* config_match_limit
Renamed all occurrences of "firstchar" to "firstbyte".
New functions:
* studysize
* namecount
* nameentrysize
* get_stringnumber
Updated OCamlMakefile.
2003-01-07: Updated OCamlMakefile to make use of "findlib".
Added support for UTF-8 character encodings.
Better installation and documentation for Win32.
Thanks to Artem Prisyznuk <tema@sit.kiev.ua> for the above
patches!
2002-12-14: Fixed a bug concerning zero-sized matches effecting
"replace", "qreplace", "substitute_substrings" and
"substitute".
Updated OCamlMakefile.
2002-12-08: Improved documentation of "pcre_exec".
2002-11-24: Fixed a bug in "full_split" concerning matched subgroups.
2002-11-12: Added a new function "extract_all" (see interface
documentation).
2002-08-16: Fixed a bug in the "split"-function:
The Perl-splitting semantics was not completely adhered to:
leading whitespace was stripped after the matching process
rather than before, which lead to incompatible behaviour
when a maximum bound was used.
Thanks to Yutaka Oiwa <oiwa@yl.is.s.u-tokyo.ac.jp> for the
bug report!
Updated OCamlMakefile.
2002-07-31: Fixed a bug in the following functions:
* replace
* qreplace
* substitute_substrings
Transformed most part of the library to make it slightly
more efficient and simple. The interface is still the same!
Updated OCamlMakefile + documentation.
2002-07-15: Fixed a mistake in the documentation.
2002-05-05: Fixed a bug with the generation of byte-code libraries that
dynamically link the PCRE.
2002-05-01: Removed C-library from distribution! Users must install it
on their own now. Reorganized whole distribution and updated
OCamlMakefile again for better support of dynamic and/or
static libraries.
2002-04-30: Updated OcamlMakefile: it does not ask for confirmation
during installation anymore!
2002-03-06: Upgraded to pcre-3.9. This should not change anything for
OCaml-users.
2002-03-01: Updated OcamlMakefile.
2002-02-24: Separated compilation of library and examples to prevent
confusions when the library needs to be installed before
one can build the examples.
2002-02-15: Fixed a bug in the pcre_exec-function which was introduced
ten days ago during correction of another bug (thanks to
Gerd Stolpmann for the report!).
2002-02-15: Added the option to compile the library statically only.
Updated INSTALL-notes to explain possible installation
problems associated with support of dynamic linking.
Added META-file for findlib.
2002-02-12: Rewrote interface documentation to support OCamldoc.
Fixed a portability bug with shared libraries.
2002-02-10: Removed project from Sourceforge for simpler maintainance.
2002-02-07: Important news: library is linked dynamically now by default.
2002-02-06: Fixed a stupid bug affecting the following functions
(thanks to Jacek Chrzaszcz for the bug report!):
* num_of_subs
* get_substring
* get_substring_ofs
* get_substrings
* extract
Also done: converted literal pattern strings in the library
and the cloc-example so that the escape char (backslash) does
not cause warnings anymore with the new OCaml-release. The
latter is more paranoid about unknown escape combinations,
requiring the user to add extra backslashes.
2002-01-07: Fixed a stupid bug: the position argument (offset) was
not correctly handled in replacement and substitution
functions, leading to wrong results. As it seems, people
seldom use arguments other than zero...
The "subst"-example now assumes that offsets other than zero
should not lead to an error if it exceeds the line length.
The line is just copied instead.
2001-12-28: Added README.win32 (courtesy of John W. Small).
Updated README so that it is generated by Hevea.
2001-11-19: Upgraded to the newest release of the underlying C-library
(PCRE-3.7).
Added a tiny patch to satisfy the Visual C++ compiler under
W2K (thanks to John W. Small!).
Updated contact address.
2001-11-17: Updated OcamlMakefile.
2001-09-15: Upgraded to the newest release of the underlying C-library
(PCRE-3.5).
Added a new function: substitute_substrings
It is similar to "substitute", but takes the full substring
information of the match rather than the matching string.
Thanks to Patrick M. Doane for proposing this missing feature!
2001-09-07: Updated OcamlMakefile
2001-08-27: Fixed a bug in the splitting function: leading whitespace was
accidently always removed when using a regular expression
rather than a pattern. This behaviour should only happen
for the default whitespace pattern, which is used if you
do not specify any pattern or regexp in the function call.
2001-06-30: Removed "Printexc.catch" from examples: is going to be
deprecated in upcoming OCaml-release.
2001-05-22: Fixed typo in documentation.
2001-04-25: Added a new function: asplit
It is identical to "split" with the exception that it
returns a string array instead of a string list. This makes
it easier for the user to access strings by index.
Added a new option to "get_substrings" and "extract": full_match
When "full_match" is true (default: yes), then the resulting
string array will contain the full match at index 0,
otherwise the result will only contain captured substrings.
Removed superfluous comments in "pcre.ml": they are already
present in the interface documentation anyway.
2001-04-08: Small patch that makes this library compile on OpenBSD, too.
2001-01-30: Made Makefile more general (allows simpler addition of
further examples).
2001-01-24: Updated OcamlMakefile: made default definition of
"OCAMLLIBPATH" backwards compatible again: some people
do not use the CVS-version of OCaml, which supports the
"-where"-option. People with the new compiler will not
notice any effect.
2001-01-06: Added a new function: exec_all
It allows you to execute pattern matching over a whole
string until no more matches can be found: then it returns
the array of all matching "substrings". You can extract
subpatterns of each of those matching substrings again with
the usual functions.
Fixed a minor inconsistency in "next_match".
2000-12-23: Updated OcamlMakefile: makes use of the new "-where"-keyword
to find the path to the standard library if it is not
defined.
2000-12-14: Pedantry in the C-interface: added "const" qualifiers.
2000-12-09: Made some functions tail-recursive (very unlikely to cause
any noticable effect for most people).
2000-12-02: Cleaned up the code a bit for distribution on SourceForge.
Speed of some operations should be very slightly improved, too.
2000-11-16: Fixed a stupid bug that could crash your programs under rare
circumstances (when you use faulty regular expressions).
Added an internally used exception (InternalError) to the
interface of the library. This allows the user to handle
the case when the C-engine exhibits undefined behaviour
(should never happen, anyway).
2000-09-27: Upgraded to the newest release of the underlying C-library
(PCRE-3.4).
See "pcre-C/ChangeLog" for more information (mostly minor
bugfixes).
Renamed "pgrep" to "pcregrep" to prevent name hiding on
Solaris (change as suggested in the C-library distribution).
2000-06-24: Updated OcamlMakefile
2000-06-13: Updated OcamlMakefile
2000-06-12: Mini-optimisation: lifted a pure value out of a function body.
2000-06-11: Updated OcamlMakefile
2000-06-08: Added installation routine + updated OcamlMakefile again:
This upgrade makes installation much easier! Read the
updated INSTALL-file!
2000-06-07: Updated to new OcamlMakefile
2000-06-05: Added a new function:
get_substring_ofs substrings n
This allows you to get the offset positions of the matching
pattern and the substrings directly from a value of type
"substring". See the interface documentation for details.
2000-05-15: Upgraded to the newest release of the underlying C-library
(PCRE-3.2).
This does not add new features, but is said to fix some
PERL-compatibility bugs and improves portability.
2000-05-04: Minor update of C-interface:
Use the new "hash_variant"-function to compute the hash value of
variants (used Callback.register before - a bit clumsy).
2000-04-24: New release: compiles with OCaml-3.00.
Lots of changes in interface! OCaml-3.00 introduced some syntax
changes for labels. Additionally, no keywords are allowed for
them. All this required quite some renamings. I tried to stick to
the new labels of the "str"-library as close as makes sense.
Sorry for this inconvenience, but I think that adhering to some
"standard" is a Good Thing...
For further information on the changes, look at the documentation
of the interface file.
2000-04-23: Minor cleanup of C-interface:
Made local functions + variables static and moved a check for
error codes (lint should be happier now).
2000-04-01: Changed linking of the library again (marginally):
The new linking semantics for byte code libraries allows passing
of flags that are remembered. This then only requires linking
executables against "pcre.cma" - the C-library ("libpcre.a") will
be linked in automatically.
2000-03-30: Cleaned up the C-interface:
Removed a possible bug in the allocation of firstchar values.
Saner handling of polymorphic variants (not hard-wired
integers anymore - registered via callbacks).
Better GC-settings: much nicer to the GC now (fewer full
cycles - hardly more memory consumption). Should make
programs run slightly faster when regular expressions are
often allocated.
Changed linking of the library to suit the semantics of
the upcoming OCaml-major release (backward compatible).
2000-02-07: Changed interface of function "foreach_file":
No idea why I implemented a tuple in the interface instead of a
curried function. Must have been the drugs... ;-)
Former interface:
val foreach_file :
string list -> (string * in_channel -> unit) -> unit
Current interface:
val foreach_file :
string list -> (string -> in_channel -> unit) -> unit
Additionally, this function now also closes the file channel
in case of an exception. The exception gets reraised,
of course.
2000-02-05: Eliminated a PERL-incompatibility of the "split"-function:
When neither the pattern nor the compiled regular
expression are specified, "split" defaults to a whitespace
pattern. However, PERL additionally strips leading
whitespace, but *only* when in "default" mode.
This last "feature" (?) was overseen during the introduction
of labels and default arguments.
2000-02-05: Updated the C-library to the newest release (pcre-3.0).
This is a major release, but the changes to the OCaml-part
are rather small: just the functionality concerning
information on compiled patterns has changed.
Instead of the former "info"-function, several ones are
provided. I think this is the most convenient way to handle
this, because it does not force the user to do explicit
pattern matching on results: due to the number of new
info-options this would have been rather confusing.
Because the old PCRE-function "pcre_info" is obsolete,
I chose to drop its OCaml-interface completely. I do not
think that it is an often used part, anyway.
See the interface file and the ChangeLog + documentation
of the C-library to see, what has changed in detail.
The other few changes just marginally effect efficiency. One
bug was present in the last release in the "info"-part
(polymorphic variants were not correctly represented).
This has changed anyway and should work fine now.
2000-01-10: "foreach_line" uses stdin as labeled (label: 'in') default
argument now.
1999-12-29: Lots of changes:
* Uses the new features of OCaml 2.99:
Labeled parameters and default arguments for much more
convenience. E.g. write
split pos:1 "foo bar"
to get the list ["oo"; "bar"].
Polymorphic variants for passing options: this change allows,
for example, using the data constructor "ANCHORED" for both
compiling flags and at matching time instead of "C_ANCHORED"
and "R_ANCHORED".
* Got rid of all the superfluous shortcuts, like "bounded_psplit"
and the like. Labeled parameters are much more readable and
convenient.
* Removed the functions compatible to the "Str"-module. It's
probably rather confusing for people to see two different kinds
of implementations.
* Renamed functions due to the use of labels and the removing of
the obsolete compatibility functions.
* Updated documentation with more details on using the library.
1999-12-21: Small change (2 chars...) to make the C-interface compile with
the newest release (OCaml 2.99).
1999-09-27: Fixed a bug which occurs, when replacements or substitutions
in strings are longer than the subject string itself.
This concerns functions "replace_all", "qreplace_all" and
"substitute_all" + their variants.
THANKS to GERD STOLPMANN (Gerd.Stolpmann@darmstadt.netsurf.de)
for finding another bug!
1999-09-21: Fixed some bugs in "pcre_intf.c":
"Store_field" was used inappropriately throughout the file,
which could lead to segfaults in the garbage collector. This
was corrected by using the "Field"-macro where appropriate.
Protected an input parameter from being reclaimed too early.
Initialized a field before throwing an exception to please
the GC.
The GC should be happy now...
THANKS to GERD STOLPMANN (Gerd.Stolpmann@darmstadt.netsurf.de)
for the patch!
1999-08-31: Updated to pcre-2.08 - this should fix some bugs. See
"pcre-C/ChangeLog" for details.
Renamed directory "pcre-C-2.07" to "pcre-C" to allow for
easier upgrading.
Added CVS-info to sources.
1999-08-24: Updated to pcre-2.07. Splitting is 100% PERL-compatible now.
New runtime option: NOTEMPTY (see interface for details).
Two additional examples: cloc and count_hash.
New functions: sregexpo, sregexp, sregexp_case_fold.
1999-08-02: Exception handling more regular now:
Raises [Invalid_argument] instead of [Failure] where
appropriate.
Raises [InternalError] if C-library exhibits undefined
behaviour (has never happened so far).
Updated comments.
1999-07-30: Bugfix in "pcre_intf.c":
"pcre_ocaml" should work now on 64-bit architectures...
1999-07-29: Small fix in "pcre_intf.c":
strict compilers (gcc is not very strict) otherwise complain
about undefined behaviour in a certain line.
Explicitely mention all include files.
Removed unused variable.
Also moved a line for efficiency...
1999-07-28: First release.
|
