Gecko [ nbspublicschool.com ]

Name	Size	Permission
App::cpanminus.3pm	14.28 KB	-r--r--r--
App::cpanminus::fatscript.3pm	26.28 KB	-r--r--r--
Bundle::DBD::mysql.3pm	4.09 KB	-r--r--r--
CPAN::Meta::Requirements.3pm	13.78 KB	-r--r--r--
CPAN::Meta::YAML.3pm	5.89 KB	-r--r--r--
Canary::Stability.3pm	5.84 KB	-r--r--r--
DBD::mysql.3pm	48.68 KB	-r--r--r--
DBD::mysql::INSTALL.3pm	30.13 KB	-r--r--r--
Data::Dump.3pm	10.51 KB	-r--r--r--
Data::Dump::Filtered.3pm	10.39 KB	-r--r--r--
Data::Dump::Trace.3pm	9 KB	-r--r--r--
Data::Validate::IP.3pm	15.68 KB	-r--r--r--
Devel::CheckLib.3pm	11.45 KB	-r--r--r--
Digest::MD5.3pm	16.16 KB	-r--r--r--
Error.3pm	21.39 KB	-r--r--r--
Error::Simple.3pm	8.15 KB	-r--r--r--
Expect.3pm	60.58 KB	-r--r--r--
Exporter.3pm	22.74 KB	-r--r--r--
Exporter::Heavy.3pm	4.1 KB	-r--r--r--
File::Copy::Recursive.3pm	18.63 KB	-r--r--r--
File::LckPwdF.3pm	11.21 KB	-r--r--r--
File::Path.3pm	32.74 KB	-r--r--r--
File::ReadBackwards.3pm	10.38 KB	-r--r--r--
File::Temp.3pm	39.49 KB	-r--r--r--
HTML::TagParser.3pm	14.01 KB	-r--r--r--
HTTP::Date.3pm	9.36 KB	-r--r--r--
HTTP::Tiny.3pm	29.24 KB	-r--r--r--
IO::AtomicFile.3pm	7.02 KB	-r--r--r--
IO::InnerFile.3pm	7.66 KB	-r--r--r--
IO::Lines.3pm	5.46 KB	-r--r--r--
IO::Pty.3pm	10.14 KB	-r--r--r--
IO::Scalar.3pm	12.19 KB	-r--r--r--
IO::ScalarArray.3pm	12.04 KB	-r--r--r--
IO::Stringy.3pm	5.72 KB	-r--r--r--
IO::Tty.3pm	9.91 KB	-r--r--r--
IO::Tty::Constant.3pm	11.25 KB	-r--r--r--
IO::Wrap.3pm	12.18 KB	-r--r--r--
IO::WrapTie.3pm	16.4 KB	-r--r--r--
JSON.3pm	64.46 KB	-r--r--r--
JSON::Syck.3pm	9.67 KB	-r--r--r--
JSON::XS.3pm	88.67 KB	-r--r--r--
JSON::XS::Boolean.3pm	4.55 KB	-r--r--r--
JSON::backportPP.3pm	65.09 KB	-r--r--r--
JSON::backportPP::Boolean.3pm	4.52 KB	-r--r--r--
JSON::backportPP::Compat5005.3...	4.39 KB	-r--r--r--
JSON::backportPP::Compat5006.3...	4.39 KB	-r--r--r--
Mail::RFC822::Address.3pm	7.11 KB	-r--r--r--
Mock::Config.3pm	7.73 KB	-r--r--r--
Module::Load.3pm	11.18 KB	-r--r--r--
Module::Load::Conditional.3pm	14.24 KB	-r--r--r--
NetAddr::IP.3pm	38.15 KB	-r--r--r--
NetAddr::IP::InetBase.3pm	14.65 KB	-r--r--r--
NetAddr::IP::Lite.3pm	26.89 KB	-r--r--r--
NetAddr::IP::Util.3pm	23.49 KB	-r--r--r--
NetAddr::IP::UtilPP.3pm	11.04 KB	-r--r--r--
POD2::DE::local::lib.3pm	24.23 KB	-r--r--r--
POD2::PT_BR::local::lib.3pm	24.62 KB	-r--r--r--
Path::Tiny.3pm	52.88 KB	-r--r--r--
Storable.3pm	45.41 KB	-r--r--r--
Template::Toolkit::Simple.3pm	13.37 KB	-r--r--r--
Test2.3pm	11.13 KB	-r--r--r--
Test2::API.3pm	37.22 KB	-r--r--r--
Test2::API::Breakage.3pm	6.63 KB	-r--r--r--
Test2::API::Context.3pm	25.52 KB	-r--r--r--
Test2::API::Instance.3pm	14.72 KB	-r--r--r--
Test2::API::InterceptResult.3p...	22 KB	-r--r--r--
Test2::API::InterceptResult::E...	26.72 KB	-r--r--r--
Test2::API::InterceptResult::H...	4.64 KB	-r--r--r--
Test2::API::InterceptResult::S...	4.77 KB	-r--r--r--
Test2::API::Stack.3pm	8.18 KB	-r--r--r--
Test2::Event.3pm	22.81 KB	-r--r--r--
Test2::Event::Bail.3pm	5.15 KB	-r--r--r--
Test2::Event::Diag.3pm	5.02 KB	-r--r--r--
Test2::Event::Encoding.3pm	5.36 KB	-r--r--r--
Test2::Event::Exception.3pm	5.3 KB	-r--r--r--
Test2::Event::Fail.3pm	4.93 KB	-r--r--r--
Test2::Event::Generic.3pm	9.66 KB	-r--r--r--
Test2::Event::Note.3pm	5.01 KB	-r--r--r--
Test2::Event::Ok.3pm	5.69 KB	-r--r--r--
Test2::Event::Pass.3pm	4.93 KB	-r--r--r--
Test2::Event::Plan.3pm	5.58 KB	-r--r--r--
Test2::Event::Skip.3pm	5.34 KB	-r--r--r--
Test2::Event::Subtest.3pm	5.25 KB	-r--r--r--
Test2::Event::TAP::Version.3pm	5.18 KB	-r--r--r--
Test2::Event::V2.3pm	8.26 KB	-r--r--r--
Test2::Event::Waiting.3pm	4.8 KB	-r--r--r--
Test2::EventFacet.3pm	5.57 KB	-r--r--r--
Test2::EventFacet::About.3pm	6.37 KB	-r--r--r--
Test2::EventFacet::Amnesty.3pm	6.16 KB	-r--r--r--
Test2::EventFacet::Assert.3pm	6.41 KB	-r--r--r--
Test2::EventFacet::Control.3pm	7.4 KB	-r--r--r--
Test2::EventFacet::Error.3pm	6.26 KB	-r--r--r--
Test2::EventFacet::Hub.3pm	7.12 KB	-r--r--r--
Test2::EventFacet::Info.3pm	8.17 KB	-r--r--r--
Test2::EventFacet::Info::Table...	7.16 KB	-r--r--r--
Test2::EventFacet::Meta.3pm	5.22 KB	-r--r--r--
Test2::EventFacet::Parent.3pm	6.31 KB	-r--r--r--
Test2::EventFacet::Plan.3pm	6.67 KB	-r--r--r--
Test2::EventFacet::Render.3pm	6.84 KB	-r--r--r--
Test2::EventFacet::Trace.3pm	12.58 KB	-r--r--r--
Test2::Formatter.3pm	7.9 KB	-r--r--r--
Test2::Formatter::TAP.3pm	6.38 KB	-r--r--r--
Test2::Hub.3pm	18.36 KB	-r--r--r--
Test2::Hub::Interceptor.3pm	4.63 KB	-r--r--r--
Test2::Hub::Interceptor::Termi...	4.67 KB	-r--r--r--
Test2::Hub::Subtest.3pm	5.48 KB	-r--r--r--
Test2::IPC.3pm	5.18 KB	-r--r--r--
Test2::IPC::Driver.3pm	10.51 KB	-r--r--r--
Test2::IPC::Driver::Files.3pm	5.49 KB	-r--r--r--
Test2::Tools::Tiny.3pm	8.45 KB	-r--r--r--
Test2::Transition.3pm	19.71 KB	-r--r--r--
Test2::Util.3pm	9.42 KB	-r--r--r--
Test2::Util::ExternalMeta.3pm	7.22 KB	-r--r--r--
Test2::Util::Facets2Legacy.3pm	9.88 KB	-r--r--r--
Test2::Util::HashBase.3pm	13.91 KB	-r--r--r--
Test2::Util::Trace.3pm	4.74 KB	-r--r--r--
Test::Builder.3pm	28.79 KB	-r--r--r--
Test::Builder::Formatter.3pm	4.85 KB	-r--r--r--
Test::Builder::IO::Scalar.3pm	11.27 KB	-r--r--r--
Test::Builder::Module.3pm	7.35 KB	-r--r--r--
Test::Builder::Tester.3pm	13.04 KB	-r--r--r--
Test::Builder::Tester::Color.3...	4.82 KB	-r--r--r--
Test::Builder::TodoDiag.3pm	4.82 KB	-r--r--r--
Test::Deep.3pm	47.56 KB	-r--r--r--
Test::Deep::NoTest.3pm	4.33 KB	-r--r--r--
Test::Fatal.3pm	10.69 KB	-r--r--r--
Test::File.3pm	23.7 KB	-r--r--r--
Test::More.3pm	43.96 KB	-r--r--r--
Test::Needs.3pm	7.27 KB	-r--r--r--
Test::Requires.3pm	5.93 KB	-r--r--r--
Test::Simple.3pm	10.67 KB	-r--r--r--
Test::Tester.3pm	17.76 KB	-r--r--r--
Test::Tester::Capture.3pm	4.59 KB	-r--r--r--
Test::Tester::CaptureRunner.3p...	4.37 KB	-r--r--r--
Test::Tutorial.3pm	25.46 KB	-r--r--r--
Test::Warnings.3pm	15.7 KB	-r--r--r--
Test::use::ok.3pm	5.52 KB	-r--r--r--
Text::Aligner.3pm	9.77 KB	-r--r--r--
Text::Table.3pm	27.18 KB	-r--r--r--
Time::Local.3pm	15.63 KB	-r--r--r--
Try::Tiny.3pm	22.09 KB	-r--r--r--
URI.3pm	40.31 KB	-r--r--r--
URI::Escape.3pm	9.58 KB	-r--r--r--
URI::Heuristic.3pm	6.84 KB	-r--r--r--
URI::QueryParam.3pm	8.26 KB	-r--r--r--
URI::Split.3pm	5.73 KB	-r--r--r--
URI::URL.3pm	6.19 KB	-r--r--r--
URI::WithBase.3pm	5.91 KB	-r--r--r--
URI::_punycode.3pm	6.32 KB	-r--r--r--
URI::data.3pm	5.98 KB	-r--r--r--
URI::file.3pm	12.16 KB	-r--r--r--
URI::ldap.3pm	7.36 KB	-r--r--r--
YAML::LibYAML.3pm	4.51 KB	-r--r--r--
YAML::Syck.3pm	12.34 KB	-r--r--r--
YAML::XS.3pm	9.57 KB	-r--r--r--
YAML::XS::LibYAML.3pm	3.99 KB	-r--r--r--
lib::core::only.3pm	7.28 KB	-r--r--r--
local::lib.3pm	32.78 KB	-r--r--r--
ok.3pm	4.55 KB	-r--r--r--
version.3pm	15.37 KB	-r--r--r--
version::Internals.3pm	31.34 KB	-r--r--r--

Code Editor : IO::Scalar.3pm

.\" Automatically generated by Pod::Man 2.27 (Pod::Simple 3.28)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{
.    if \nF \{
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "IO::Scalar 3"
.TH IO::Scalar 3 "2020-01-16" "perl v5.16.3" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
IO::Scalar \- IO:: interface for reading/writing a scalar
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
Perform I/O on strings, using the basic \s-1OO\s0 interface...
.PP
.Vb 3
\&    use 5.005;
\&    use IO::Scalar;
\&    $data = "My message:\en";
\&
\&    ### Open a handle on a string, and append to it:
\&    $SH = new IO::Scalar \e$data;
\&    $SH\->print("Hello");
\&    $SH\->print(", world!\enBye now!\en");
\&    print "The string is now: ", $data, "\en";
\&
\&    ### Open a handle on a string, read it line\-by\-line, then close it:
\&    $SH = new IO::Scalar \e$data;
\&    while (defined($_ = $SH\->getline)) {
\&        print "Got line: $_";
\&    }
\&    $SH\->close;
\&
\&    ### Open a handle on a string, and slurp in all the lines:
\&    $SH = new IO::Scalar \e$data;
\&    print "All lines:\en", $SH\->getlines;
\&
\&    ### Get the current position (either of two ways):
\&    $pos = $SH\->getpos;
\&    $offset = $SH\->tell;
\&
\&    ### Set the current position (either of two ways):
\&    $SH\->setpos($pos);
\&    $SH\->seek($offset, 0);
\&
\&    ### Open an anonymous temporary scalar:
\&    $SH = new IO::Scalar;
\&    $SH\->print("Hi there!");
\&    print "I printed: ", ${$SH\->sref}, "\en";      ### get at value
.Ve
.PP
Don't like \s-1OO\s0 for your I/O?  No problem.
Thanks to the magic of an invisible \fItie()\fR, the following now
works out of the box, just as it does with IO::Handle:
.PP
.Vb 3
\&    use 5.005;
\&    use IO::Scalar;
\&    $data = "My message:\en";
\&
\&    ### Open a handle on a string, and append to it:
\&    $SH = new IO::Scalar \e$data;
\&    print $SH "Hello";
\&    print $SH ", world!\enBye now!\en";
\&    print "The string is now: ", $data, "\en";
\&
\&    ### Open a handle on a string, read it line\-by\-line, then close it:
\&    $SH = new IO::Scalar \e$data;
\&    while (<$SH>) {
\&        print "Got line: $_";
\&    }
\&    close $SH;
\&
\&    ### Open a handle on a string, and slurp in all the lines:
\&    $SH = new IO::Scalar \e$data;
\&    print "All lines:\en", <$SH>;
\&
\&    ### Get the current position (WARNING: requires 5.6):
\&    $offset = tell $SH;
\&
\&    ### Set the current position (WARNING: requires 5.6):
\&    seek $SH, $offset, 0;
\&
\&    ### Open an anonymous temporary scalar:
\&    $SH = new IO::Scalar;
\&    print $SH "Hi there!";
\&    print "I printed: ", ${$SH\->sref}, "\en";      ### get at value
.Ve
.PP
And for you folks with 1.x code out there: the old \fItie()\fR style still works,
though this is \fIunnecessary and deprecated\fR:
.PP
.Vb 1
\&    use IO::Scalar;
\&
\&    ### Writing to a scalar...
\&    my $s;
\&    tie *OUT, \*(AqIO::Scalar\*(Aq, \e$s;
\&    print OUT "line 1\enline 2\en", "line 3\en";
\&    print "String is now: $s\en"
\&
\&    ### Reading and writing an anonymous scalar...
\&    tie *OUT, \*(AqIO::Scalar\*(Aq;
\&    print OUT "line 1\enline 2\en", "line 3\en";
\&    tied(OUT)\->seek(0,0);
\&    while (<OUT>) {
\&        print "Got line: ", $_;
\&    }
.Ve
.PP
Stringification works, too!
.PP
.Vb 4
\&    my $SH = new IO::Scalar \e$data;
\&    print $SH "Hello, ";
\&    print $SH "world!";
\&    print "I printed: $SH\en";
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
This class is part of the IO::Stringy distribution;
see IO::Stringy for change log and general information.
.PP
The IO::Scalar class implements objects which behave just like
IO::Handle (or FileHandle) objects, except that you may use them
to write to (or read from) scalars.  These handles are
automatically \f(CW\*(C`tiehandle\*(C'\fRd (though please see \*(L"\s-1WARNINGS\*(R"\s0
for information relevant to your Perl version).
.PP
Basically, this:
.PP
.Vb 4
\&    my $s;
\&    $SH = new IO::Scalar \e$s;
\&    $SH\->print("Hel", "lo, ");         ### OO style
\&    $SH\->print("world!\en");            ### ditto
.Ve
.PP
Or this:
.PP
.Vb 4
\&    my $s;
\&    $SH = tie *OUT, \*(AqIO::Scalar\*(Aq, \e$s;
\&    print OUT "Hel", "lo, ";           ### non\-OO style
\&    print OUT "world!\en";              ### ditto
.Ve
.PP
Causes \f(CW$s\fR to be set to:
.PP
.Vb 1
\&    "Hello, world!\en"
.Ve
.SH "PUBLIC INTERFACE"
.IX Header "PUBLIC INTERFACE"
.SS "Construction"
.IX Subsection "Construction"
.IP "new [\s-1ARGS...\s0]" 4
.IX Item "new [ARGS...]"
\&\fIClass method.\fR
Return a new, unattached scalar handle.
If any arguments are given, they're sent to \fIopen()\fR.
.IP "open [\s-1SCALARREF\s0]" 4
.IX Item "open [SCALARREF]"
\&\fIInstance method.\fR
Open the scalar handle on a new scalar, pointed to by \s-1SCALARREF.\s0
If no \s-1SCALARREF\s0 is given, a \*(L"private\*(R" scalar is created to hold
the file data.
.Sp
Returns the self object on success, undefined on error.
.IP "opened" 4
.IX Item "opened"
\&\fIInstance method.\fR
Is the scalar handle opened on something?
.IP "close" 4
.IX Item "close"
\&\fIInstance method.\fR
Disassociate the scalar handle from its underlying scalar.
Done automatically on destroy.
.SS "Input and output"
.IX Subsection "Input and output"
.IP "flush" 4
.IX Item "flush"
\&\fIInstance method.\fR
No-op, provided for \s-1OO\s0 compatibility.
.IP "fileno" 4
.IX Item "fileno"
\&\fIInstance method.\fR
No-op, returns undef
.IP "getc" 4
.IX Item "getc"
\&\fIInstance method.\fR
Return the next character, or undef if none remain.
.IP "getline" 4
.IX Item "getline"
\&\fIInstance method.\fR
Return the next line, or undef on end of string.
Can safely be called in an array context.
Currently, lines are delimited by \*(L"\en\*(R".
.IP "getlines" 4
.IX Item "getlines"
\&\fIInstance method.\fR
Get all remaining lines.
It will \fIcroak()\fR if accidentally called in a scalar context.
.IP "print \s-1ARGS...\s0" 4
.IX Item "print ARGS..."
\&\fIInstance method.\fR
Print \s-1ARGS\s0 to the underlying scalar.
.Sp
\&\fBWarning:\fR this continues to always cause a seek to the end
of the string, but if you perform \fIseek()\fRs and \fItell()\fRs, it is
still safer to explicitly seek-to-end before subsequent \fIprint()\fRs.
.IP "read \s-1BUF, NBYTES,\s0 [\s-1OFFSET\s0]" 4
.IX Item "read BUF, NBYTES, [OFFSET]"
\&\fIInstance method.\fR
Read some bytes from the scalar.
Returns the number of bytes actually read, 0 on end-of-file, undef on error.
.IP "write \s-1BUF, NBYTES,\s0 [\s-1OFFSET\s0]" 4
.IX Item "write BUF, NBYTES, [OFFSET]"
\&\fIInstance method.\fR
Write some bytes to the scalar.
.IP "sysread \s-1BUF, LEN,\s0 [\s-1OFFSET\s0]" 4
.IX Item "sysread BUF, LEN, [OFFSET]"
\&\fIInstance method.\fR
Read some bytes from the scalar.
Returns the number of bytes actually read, 0 on end-of-file, undef on error.
.IP "syswrite \s-1BUF, NBYTES,\s0 [\s-1OFFSET\s0]" 4
.IX Item "syswrite BUF, NBYTES, [OFFSET]"
\&\fIInstance method.\fR
Write some bytes to the scalar.
.SS "Seeking/telling and other attributes"
.IX Subsection "Seeking/telling and other attributes"
.IP "autoflush" 4
.IX Item "autoflush"
\&\fIInstance method.\fR
No-op, provided for \s-1OO\s0 compatibility.
.IP "binmode" 4
.IX Item "binmode"
\&\fIInstance method.\fR
No-op, provided for \s-1OO\s0 compatibility.
.IP "clearerr" 4
.IX Item "clearerr"
\&\fIInstance method.\fR  Clear the error and \s-1EOF\s0 flags.  A no-op.
.IP "eof" 4
.IX Item "eof"
\&\fIInstance method.\fR  Are we at end of file?
.IP "seek \s-1OFFSET, WHENCE\s0" 4
.IX Item "seek OFFSET, WHENCE"
\&\fIInstance method.\fR  Seek to a given position in the stream.
.IP "sysseek \s-1OFFSET, WHENCE\s0" 4
.IX Item "sysseek OFFSET, WHENCE"
\&\fIInstance method.\fR Identical to \f(CW\*(C`seek OFFSET, WHENCE\*(C'\fR, \fIq.v.\fR
.IP "tell" 4
.IX Item "tell"
\&\fIInstance method.\fR
Return the current position in the stream, as a numeric offset.
.IP "setpos \s-1POS\s0" 4
.IX Item "setpos POS"
\&\fIInstance method.\fR
Set the current position, using the opaque value returned by \f(CW\*(C`getpos()\*(C'\fR.
.IP "getpos" 4
.IX Item "getpos"
\&\fIInstance method.\fR
Return the current position in the string, as an opaque object.
.IP "sref" 4
.IX Item "sref"
\&\fIInstance method.\fR
Return a reference to the underlying scalar.
.SH "AUTHOR"
.IX Header "AUTHOR"
Eryq (\fIeryq@zeegee.com\fR).
President, ZeeGee Software Inc (\fIhttp://www.zeegee.com\fR).
.SH "CONTRIBUTORS"
.IX Header "CONTRIBUTORS"
Dianne Skoll (\fIdfs@roaringpenguin.com\fR).
.SH "COPYRIGHT & LICENSE"
.IX Header "COPYRIGHT & LICENSE"
Copyright (c) 1997 Erik (Eryq) Dorfman, ZeeGee Software, Inc. All rights reserved.
.PP
This program is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.

${this.title}

Code Editor : IO::Scalar.3pm