1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
|
package PerlIO::scalar;
our $VERSION = '0.02';
use XSLoader ();
XSLoader::load 'PerlIO::scalar';
1;
__END__
=head1 NAME
PerlIO::scalar - in-memory IO, scalar IO
=head1 SYNOPSIS
my $scalar = '';
...
open my $fh, "<", \$scalar or die;
open my $fh, ">", \$scalar or die;
open my $fh, ">>", \$scalar or die;
or
my $scalar = '';
...
open my $fh, "<:scalar", \$scalar or die;
open my $fh, ">:scalar", \$scalar or die;
open my $fh, ">>:scalar", \$scalar or die;
=head1 DESCRIPTION
A filehandle is opened but the file operations are performed "in-memory"
on a scalar variable. All the normal file operations can be performed
on the handle. The scalar is considered a stream of bytes. Currently
fileno($fh) returns C<undef>.
=head1 IMPLEMENTATION NOTE
C<PerlIO::scalar> only exists to use XSLoader to load C code that
provides support for treating a scalar as an "in memory" file.
One does not need to explicitly C<use PerlIO::scalar>.
=cut
|
