Seth Woolley's Man Viewer

PerlIO::scalar(3)      Perl Programmers Reference Guide      PerlIO::scalar(3)



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

SYNOPSIS
          my $scalar = '';
          ...
          open(2,3,n) my $fh, "<",  \$scalar or die;
          open(2,3,n) my $fh, ">",  \$scalar or die;
          open(2,3,n) my $fh, ">>", \$scalar or die;

       or

          my $scalar = '';
          ...
          open(2,3,n) my $fh, "<:scalar",  \$scalar or die;
          open(2,3,n) my $fh, ">:scalar",  \$scalar or die;
          open(2,3,n) my $fh, ">>:scalar", \$scalar or die;

DESCRIPTION
       A filehandle is opened but the file(1,n) operations are performed "in-mem-
       ory" on a scalar variable.  All the normal file(1,n) operations can be per-
       formed on the handle. The scalar is considered a stream of bytes.  Cur-
       rently fileno($fh) returns "undef".

IMPLEMENTATION NOTE
       "PerlIO::scalar" only exists to use XSLoader to load(7,n) C code that pro-
       vides support for treating a scalar as an "in(1,8) memory" file.  One does
       not need to explicitly "use PerlIO::scalar".



perl v5.8.5                       2001-09-21                 PerlIO::scalar(3)