File::Stream

Current version is 2.20.

Download

README

File::Stream version 2.20
=========================

Perl filehandles are streams, but sometimes they just aren't powerful enough.
This module offers to have streams from filehandles searched with regexes
and allows the global input record separator variable to contain regexes.

Thus, readline() and the <> operator can now return records delimited
by regular expression matches.

Please see the POD documentation in the module file for important CAVEATS.

INSTALLATION

To install this module type the following:

   perl Build.PL
   ./Build
   ./Build test
   ./Build install

On platforms that don't support the "./" notation, that would be:

   perl Build.PL
   perl Build
   perl Build test
   perl Build install

If you wish, you may use the old MakeMaker style instead:

   perl Makefile.PL
   make
   make test
   make install

DEPENDENCIES

This module requires these other modules and libraries:

  Carp
  Test::More
  YAPE::Regex

CONTRIBUTIONS

Many thanks go to Simon Cozens for the original idea and much valuable
input. It was great fun talking about some of the weirder features of Perl.
Equally many thanks to Autrijus Tang for much help with the fiendish regexes
I couldn't handle and Ben Tilly for suggesting the use of the ${} regex
construct.

Also, I owe thanks to Jeff 'japhy' Pinyan for writing the YAPE::Regex
module which made my life much easier.

COPYRIGHT AND LICENCE

Copyright (C) 2003-2008 Steffen Mller
Author can be reached at stream-module at steffen-mueller dot net.

This library is free software; you can redistribute it and/or modify
it under the same terms as Perl itself.

Documentation

File::Stream

Change Log

Revision history for Perl extension File::Stream.

2.20  Wed Jul 16 12:24:21 2008
        - supply die_on_anchors option to constructor to suppress the
          fatal error thrown for anchors in regexes.

2.10  Mon Dec 19 16:11:42 2005
	- Added an implementation of SEEK and TELL. Idea and implementation were
	  kindly supplied by Phil Whineray.

2.00  Tue Nov 15 15:45:18 2005
	- Now requiring YAPE::Regex 3.02 since 3.01 contained a
	  show-stopping bug.
	- Switched to using Module::Build.

1.11  Tue Mar  2 13:46:44 2003
	- Added test for anchors in regex delimiter. croaks on detection.

1.10  Sun Oct 12 14:17:56 2003
	- Added funky regex heuristics. :)

1.00  Sat Oct  4 14:36:13 2003
	- original version as uploaded to CPAN