README
1NAME
2 IO-stringy - I/O on in-core objects like strings and arrays
3
4SYNOPSIS
5 use strict;
6 use warnings;
7
8 use IO::AtomicFile; # Write a file which is updated atomically
9 use IO::InnerFile; # define a file inside another file
10 use IO::Lines; # I/O handle to read/write to array of lines
11 use IO::Scalar; # I/O handle to read/write to a string
12 use IO::ScalarArray; # I/O handle to read/write to array of scalars
13 use IO::Wrap; # Wrap old-style FHs in standard OO interface
14 use IO::WrapTie; # Tie your handles & retain full OO interface
15
16 # ...
17
18DESCRIPTION
19 This toolkit primarily provides modules for performing both traditional
20 and object-oriented i/o) on things *other* than normal filehandles; in
21 particular, IO::Scalar, IO::ScalarArray, and IO::Lines.
22
23 In the more-traditional IO::Handle front, we have IO::AtomicFile which
24 may be used to painlessly create files which are updated atomically.
25
26 And in the "this-may-prove-useful" corner, we have IO::Wrap, whose
27 exported wraphandle() function will clothe anything that's not a blessed
28 object in an IO::Handle-like wrapper... so you can just use OO syntax
29 and stop worrying about whether your function's caller handed you a
30 string, a globref, or a FileHandle.
31
32AUTHOR
33 Eryq (eryq@zeegee.com). President, ZeeGee Software Inc
34 (http://www.zeegee.com).
35
36CONTRIBUTORS
37 Dianne Skoll (dfs@roaringpenguin.com).
38
39COPYRIGHT & LICENSE
40 Copyright (c) 1997 Erik (Eryq) Dorfman, ZeeGee Software, Inc. All rights
41 reserved.
42
43 This program is free software; you can redistribute it and/or modify it
44 under the same terms as Perl itself.
45
46