IO::File - supply object methods for filehandles
use IO::File;
$fh = new IO::File;
if ($fh->open("< file")) {
print <$fh>;
$fh->close;
}
$fh = new IO::File "> file";
if (defined $fh) {
print $fh "bar\n";
$fh->close;
}
$fh = new IO::File "file", "r";
if (defined $fh) {
print <$fh>;
undef $fh; # automatically closes the file
}
$fh = new IO::File "file", O_WRONLY|O_APPEND;
if (defined $fh) {
print $fh "corge\n";
$pos = $fh->getpos;
$fh->setpos($pos);
undef $fh; # automatically closes the file
}
autoflush STDOUT 1;
IO::File inherits from IO::Handle and IO::Seekable. It extends these classes with methods that are specific to file handles.
IO::File. If it receives any parameters, they are passed to the method open; if the open fails, the object is destroyed. Otherwise, it is returned to
the caller.
IO::File opened for read/write on a newly created temporary file. On systems where
this is possible, the temporary file is anonymous (i.e. it is unlinked
after creation, but held open). If the temporary file cannot be created or
opened, the IO::File object is destroyed. Otherwise, it is returned to the caller.
If IO::File::open receives a Perl mode string (``>'', ``+<'', etc.) or a
POSIX
fopen() mode string (``w'', ``r+'', etc.), it uses the basic Perl
open operator.
If IO::File::open is given a numeric mode, it passes that mode and the optional permissions
value to the Perl sysopen operator. For convenience, IO::File::import tries to import the
O_XXX constants from the Fcntl module. If dynamic
loading is not available, this may fail, but the rest of IO::File will
still work.
the perlfunc manpage, I/O Operators, Handle Seekable
Derived from FileHandle.pm by Graham Barr <bodg@tiuk.ti.com>.
If rather than formatting bugs, you encounter substantive content errors in these documents, such as mistakes in the explanations or code, please use the perlbug utility included with the Perl distribution.