This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).

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



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

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;

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 "undef".

IMPLEMENTATION NOTE
       "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 "use PerlIO::scalar".



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