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.207 1999/04/18 04:14:04 eryq Exp $ AUTHOR Eryq (eryq@zeegee.com). President, ZeeGee Software Inc (http://www.zeegee.com). Enjoy. Yell if it breaks.