You are viewing the version of this documentation from Perl 5.6.0. View the latest version

CONTENTS

NAME

IO::Seekable - supply seek based methods for I/O objects

SYNOPSIS

use IO::Seekable;
package IO::Something;
@ISA = qw(IO::Seekable);

DESCRIPTION

IO::Seekable does not have a constructor of its own as it is intended to be inherited by other IO::Handle based objects. It provides methods which allow seeking of the file descriptors.

If the C functions fgetpos() and fsetpos() are available, then $io-<getpos returns an opaque value that represents the current position of the IO::File, and $io->setpos(POS) uses that value to return to a previously visited position.

See perlfunc for complete descriptions of each of the following supported IO::Seekable methods, which are just front ends for the corresponding built-in functions:

$io->seek( POS, WHENCE )
$io->sysseek( POS, WHENCE )
$io->tell

SEE ALSO

perlfunc, "I/O Operators" in perlop, IO::Handle IO::File

HISTORY

Derived from FileHandle.pm by Graham Barr <gbarr@pobox.com>