NAME
IO-stringy - I/O on in-core objects like strings and arrays
SYNOPSIS
IO::
::AtomicFile adpO Write a file which is updated atomically ERYQ
::Lines bdpO I/O handle to read/write to array of lines ERYQ
::Scalar RdpO I/O handle to read/write to a string ERYQ
::ScalarArray RdpO I/O handle to read/write to array of scalars ERYQ
::Wrap RdpO Wrap old-style FHs in standard OO interface ERYQ
::WrapTie adpO Tie your handles & retain full OO interface ERYQ
DESCRIPTION
This toolkit primarily provides modules for performing both traditional
and object-oriented i/o) on things *other* than normal filehandles; in
particular, the IO::Scalar manpage, the IO::ScalarArray manpage, and the
IO::Lines manpage.
If you have access to tie(), these classes will make use of the the
IO::WrapTie manpage module to inherit a convenient new_tie()
constructor. It also exports a nice wraptie() function.
In the more-traditional IO::Handle front, we have the IO::AtomicFile
manpage which may be used to painlessly create files which are updated
atomically.
And in the "this-may-prove-useful" corner, we have the IO::Wrap manpage,
whose exported wraphandle() function will clothe anything that's not a
blessed object in an IO::Handle-like wrapper... so you can just use OO
syntax and stop worrying about whether your function's caller handed you
a string, a globref, or a FileHandle.
INSTALLATION
You know the drill...
perl Makefile.PL
make test
make install
CHANGE LOG
Version 1.206
Added creation of ./testout when Makefile.PL is run.
Version 1.205
Verified for Perl5.005.
Version 1.202
New IO::WrapTie and IO::AtomicFile added.
Version 1.110
Added IO::WrapTie.
Version 1.107
Added IO::Lines, and made some bug fixes to IO::ScalarArray. Also,
added getc().
Version 1.105
No real changes; just upgraded IO::Wrap to have a $VERSION string.
VERSION
$Id: Stringy.pm,v 1.206 1999/04/18 03:43:41 eryq Exp $
AUTHOR
Eryq (
[email protected]). President, ZeeGee Software Inc
(
http://www.zeegee.com).
Enjoy. Yell if it breaks.
