mingw/html/lib/PerlIO/scalar.html

   1 <?xml version="1.0" ?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml">
   4 <head>
   5 <title>PerlIO::scalar - in-memory IO, scalar IO</title>
   6 <meta http-equiv="content-type" content="text/html; charset=utf-8" />
   7 <link rev="made" href="mailto:" />
   8 </head>
   9
  10 <body style="background-color: white">
  11 <table border="0" width="100%" cellspacing="0" cellpadding="3">
  12 <tr><td class="block" style="background-color: #cccccc" valign="middle">
  13 <big><strong><span class="block">&nbsp;PerlIO::scalar - in-memory IO, scalar IO</span></strong></big>
  14 </td></tr>
  15 </table>
  16
  17 <p><a name="__index__"></a></p>
  18 <!-- INDEX BEGIN -->
  19
  20 <ul>
  21
  22         <li><a href="#name">NAME</a></li>
  23         <li><a href="#synopsis">SYNOPSIS</a></li>
  24         <li><a href="#description">DESCRIPTION</a></li>
  25         <li><a href="#implementation_note">IMPLEMENTATION NOTE</a></li>
  26 </ul>
  27 <!-- INDEX END -->
  28
  29 <hr />
  30 <p>
  31 </p>
  32 <h1><a name="name">NAME</a></h1>
  33 <p>PerlIO::scalar - in-memory IO, scalar IO</p>
  34 <p>
  35 </p>
  36 <hr />
  37 <h1><a name="synopsis">SYNOPSIS</a></h1>
  38 <pre>
  39    my $scalar = '';
  40    ...
  41    open my $fh, &quot;&lt;&quot;,  \$scalar or die;
  42    open my $fh, &quot;&gt;&quot;,  \$scalar or die;
  43    open my $fh, &quot;&gt;&gt;&quot;, \$scalar or die;</pre>
  44 <p>or</p>
  45 <pre>
  46    my $scalar = '';
  47    ...
  48    open my $fh, &quot;&lt;:scalar&quot;,  \$scalar or die;
  49    open my $fh, &quot;&gt;:scalar&quot;,  \$scalar or die;
  50    open my $fh, &quot;&gt;&gt;:scalar&quot;, \$scalar or die;</pre>
  51 <p>
  52 </p>
  53 <hr />
  54 <h1><a name="description">DESCRIPTION</a></h1>
  55 <p>A filehandle is opened but the file operations are performed ``in-memory''
  56 on a scalar variable.  All the normal file operations can be performed
  57 on the handle. The scalar is considered a stream of bytes.  Currently
  58 <code>fileno($fh)</code> returns <a href="file://C|\msysgit\mingw\html/pod/perlfunc.html#item_undef"><code>undef</code></a>.</p>
  59 <p>
  60 </p>
  61 <hr />
  62 <h1><a name="implementation_note">IMPLEMENTATION NOTE</a></h1>
  63 <p><code>PerlIO::scalar</code> only exists to use XSLoader to load C code that
  64 provides support for treating a scalar as an ``in memory'' file.
  65 One does not need to explicitly <code>use PerlIO::scalar</code>.</p>
  66 <table border="0" width="100%" cellspacing="0" cellpadding="3">
  67 <tr><td class="block" style="background-color: #cccccc" valign="middle">
  68 <big><strong><span class="block">&nbsp;PerlIO::scalar - in-memory IO, scalar IO</span></strong></big>
  69 </td></tr>
  70 </table>
  71
  72 </body>
  73
  74 </html>