[p5sagit/p5-mst-13.2.git] / ext / PerlIO / scalar / scalar.pm

package PerlIO::scalar;
our $VERSION = '0.02';
use XSLoader ();
XSLoader::load 'PerlIO::scalar';
1;
__END__

=head1 NAME

PerlIO::scalar - support module for in-memory IO.

=head1 SYNOPSIS

   open($fh,"<",\$scalar);
   open($fh,">",\$scalar);

or

   open($fh,"<:scalar",\$scalar);
   open($fh,">:scalar",\$scalar);

=head1 DESCRIPTION

C<PerlIO::scalar> only exists to use XSLoader to load C code that provides
support for treating a scalar as an "in memory" file.

All normal file operations can be performed on the handle. The scalar
is considered a stream of bytes. Currently fileno($fh) returns C<undef>.

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