<html><head><meta name="color-scheme" content="light dark"></head><body><pre style="word-wrap: break-word; white-space: pre-wrap;">package PerlIO::scalar;
our $VERSION = '0.31';
require XSLoader;
XSLoader::load();
1;
__END__

=head1 NAME

PerlIO::scalar - in-memory IO, scalar IO

=head1 SYNOPSIS

   my $scalar = '';
   ...
   open my $fh, "&lt;",  \$scalar or die;
   open my $fh, "&gt;",  \$scalar or die;
   open my $fh, "&gt;&gt;", \$scalar or die;

or

   my $scalar = '';
   ...
   open my $fh, "&lt;:scalar",  \$scalar or die;
   open my $fh, "&gt;:scalar",  \$scalar or die;
   open my $fh, "&gt;&gt;: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 -1.

Attempting to open a read-only scalar for writing will fail, and if
warnings are enabled, produce a warning.

=head1 IMPLEMENTATION NOTE

C&lt;PerlIO::scalar&gt; 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&lt;use PerlIO::scalar&gt;.

=cut
</pre></body></html>