PerlIO::scalar3p

In-memory io, scalar io

Usage

   my $scalar = '';
   ...
   open my $fh, "<",  \$scalar or die;
   open my $fh, ">",  \$scalar or die;
   open my $fh, ">>", \$scalar or die;

   my $scalar = '';
   ...
   open my $fh, "<:scalar",  \$scalar or die;
   open my $fh, ">:scalar",  \$scalar or die;
   open my $fh, ">>:scalar", \$scalar or die;

Overview

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.

Implementation note

"PerlIO::scalar" only exists as a stub. One does not need to explicitly "use PerlIO::scalar".

Releases

32 releases since OpenBSD 5.0; the text changed 20 times.

5.0–5.3
5.4–5.5
5.6
5.7
5.8–5.9
6.0
6.1
6.2
6.3–6.4
6.5
6.6
6.7
6.8
6.9–7.2
7.3
7.4
7.5
7.6
7.7–7.8
7.9
8.0