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, IO::Scalar, IO::ScalarArray, and IO::Lines.

    If you have access to tie(), these classes will make use of the
    IO::WrapTie module to inherit a convenient new_tie() constructor. It
    also exports a nice wraptie() function.

    In the more-traditional IO::Handle front, we have IO::AtomicFile which
    may be used to painlessly create files which are updated atomically.

    And in the "this-may-prove-useful" corner, we have IO::Wrap, 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

VERSION
    $Id: Stringy.pm,v 1.215 2000/09/05 03:53:58 eryq Exp $

CHANGE LOG
    Version 1.215   (2000/09/05)
        Added 'bool' overload to '""' overload, so object always evaluates
        to true. (Whew. Glad I caught this before it went to CPAN.)

    Version 1.214   (2000/09/03)
        Evaluating an IO::Scalar in a string context now yields the
        underlying string. *Thanks to B. K. Oxley (binkley) for this.*

    Version 1.213   (2000/08/16)
        Minor documentation fixes.

    Version 1.212   (2000/06/02)
        Fixed IO::InnerFile incompatibility with Perl5.004. *Thanks to many
        folks for reporting this.*

    Version 1.210   (2000/04/17)
        Added flush() and other no-op methods. *Thanks to Doru Petrescu for
        suggesting this.*

    Version 1.209   (2000/03/17)
        Small bug fixes.

    Version 1.208   (2000/03/14)
        Incorporated a number of contributed patches and extensions, mostly
        related to speed hacks, support for "offset", and WRITE/CLOSE
        methods.

    Version 1.206   (1999/04/18)
        Added creation of ./testout when Makefile.PL is run.

    Version 1.205   (1999/01/15)
        Verified for Perl5.005.

    Version 1.202   (1998/04/18)
        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.

AUTHOR
    Eryq (eryq@zeegee.com). President, ZeeGee Software Inc
    (http://www.zeegee.com).

    Enjoy. Yell if it breaks.