diff options
author | Norbert Preining <preining@logic.at> | 2010-05-12 16:54:37 +0000 |
---|---|---|
committer | Norbert Preining <preining@logic.at> | 2010-05-12 16:54:37 +0000 |
commit | 661c41a09e39a182865e0b51e34cc995a0dc96e8 (patch) | |
tree | 2f79bb1406e22fdcb2587be8ffda6c0c609d7932 /Master/tlpkg/tlperl/lib/PerlIO/scalar.pm | |
parent | b645030efc22e13c2498a1522083634ab91b2de1 (diff) |
move tlperl.straw to tlperl
git-svn-id: svn://tug.org/texlive/trunk@18210 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/tlpkg/tlperl/lib/PerlIO/scalar.pm')
-rwxr-xr-x | Master/tlpkg/tlperl/lib/PerlIO/scalar.pm | 41 |
1 files changed, 41 insertions, 0 deletions
diff --git a/Master/tlpkg/tlperl/lib/PerlIO/scalar.pm b/Master/tlpkg/tlperl/lib/PerlIO/scalar.pm new file mode 100755 index 00000000000..5188ddbc3c9 --- /dev/null +++ b/Master/tlpkg/tlperl/lib/PerlIO/scalar.pm @@ -0,0 +1,41 @@ +package PerlIO::scalar; +our $VERSION = '0.07'; +use XSLoader (); +XSLoader::load 'PerlIO::scalar'; +1; +__END__ + +=head1 NAME + +PerlIO::scalar - in-memory IO, scalar IO + +=head1 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; + +=head1 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 -1. + +=head1 IMPLEMENTATION NOTE + +C<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 C<use PerlIO::scalar>. + +=cut |