home *** CD-ROM | disk | FTP | other *** search
-
- <HTML>
- <HEAD>
- <TITLE>IO::Seekable - supply seek based methods for I/O objects</TITLE>
- <LINK REL="stylesheet" HREF="../../Active.css" TYPE="text/css">
- <LINK REV="made" HREF="mailto:">
- </HEAD>
-
- <BODY>
- <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
- <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
- <STRONG><P CLASS=block> IO::Seekable - supply seek based methods for I/O objects</P></STRONG>
- </TD></TR>
- </TABLE>
-
- <A NAME="__index__"></A>
- <!-- INDEX BEGIN -->
-
- <UL>
-
- <LI><A HREF="#name">NAME</A></LI><LI><A HREF="#supportedplatforms">SUPPORTED PLATFORMS</A></LI>
-
- <LI><A HREF="#synopsis">SYNOPSIS</A></LI>
- <LI><A HREF="#description">DESCRIPTION</A></LI>
- <LI><A HREF="#see also">SEE ALSO</A></LI>
- <LI><A HREF="#history">HISTORY</A></LI>
- </UL>
- <!-- INDEX END -->
-
- <HR>
- <P>
- <H1><A NAME="name">NAME</A></H1>
- <P>IO::Seekable - supply seek based methods for I/O objects</P>
- <P>
- <HR>
- <H1><A NAME="supportedplatforms">SUPPORTED PLATFORMS</A></H1>
- <UL>
- <LI>Linux</LI>
- <LI>Solaris</LI>
- <LI>Windows</LI>
- </UL>
- <HR>
- <H1><A NAME="synopsis">SYNOPSIS</A></H1>
- <PRE>
- use IO::Seekable;
- package IO::Something;
- @ISA = qw(IO::Seekable);</PRE>
- <P>
- <HR>
- <H1><A NAME="description">DESCRIPTION</A></H1>
- <P><CODE>IO::Seekable</CODE> does not have a constructor of its own as it is intended to
- be inherited by other <CODE>IO::Handle</CODE> based objects. It provides methods
- which allow seeking of the file descriptors.</P>
- <P>If the C functions <CODE>fgetpos()</CODE> and <CODE>fsetpos()</CODE> are available, then
- <CODE>$io-<getpos</CODE> returns an opaque value that represents the
- current position of the IO::File, and <CODE>$io->setpos(POS)</CODE> uses
- that value to return to a previously visited position.</P>
- <P>See <A HREF="../../lib/Pod/perlfunc.html">the perlfunc manpage</A> for complete descriptions of each of the following
- supported <CODE>IO::Seekable</CODE> methods, which are just front ends for the
- corresponding built-in functions:</P>
- <PRE>
- $io->seek( POS, WHENCE )
- $io->sysseek( POS, WHENCE )
- $io->tell</PRE>
- <P>
- <HR>
- <H1><A NAME="see also">SEE ALSO</A></H1>
- <P><A HREF="../../lib/Pod/perlfunc.html">the perlfunc manpage</A>,
- <A HREF="../../lib/Pod/perlop.html#i/o operators">I/O Operators in the perlop manpage</A>,
- <A HREF="../../lib/IO/Handle.html">the IO::Handle manpage</A>
- <A HREF="../../lib/IO/File.html">the IO::File manpage</A></P>
- <P>
- <HR>
- <H1><A NAME="history">HISTORY</A></H1>
- <P>Derived from FileHandle.pm by Graham Barr <<A HREF="mailto:gbarr@pobox.com">gbarr@pobox.com</A>></P>
- <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
- <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
- <STRONG><P CLASS=block> IO::Seekable - supply seek based methods for I/O objects</P></STRONG>
- </TD></TR>
- </TABLE>
-
- </BODY>
-
- </HTML>
-