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