ext/PerlIO/scalar/scalar.pm

   1 package PerlIO::scalar;
   2 our $VERSION = '0.02';
   3 use XSLoader ();
   4 XSLoader::load 'PerlIO::scalar';
   5 1;
   6 __END__
   7
   8 =head1 NAME
   9
  10 PerlIO::scalar - support module for in-memory IO.
  11
  12 =head1 SYNOPSIS
  13
  14    open($fh,"<",\$scalar);
  15    open($fh,">",\$scalar);
  16
  17 or
  18
  19    open($fh,"<:scalar",\$scalar);
  20    open($fh,">:scalar",\$scalar);
  21
  22 =head1 DESCRIPTION
  23
  24 C<PerlIO::scalar> only exists to use XSLoader to load C code that provides
  25 support for treating a scalar as an "in memory" file.
  26
  27 All normal file operations can be performed on the handle. The scalar
  28 is considered a stream of bytes. Currently fileno($fh) returns C<undef>.
  29
  30 =cut
  31
  32